{
  "interval": {
    "intervalStart": "2025-10-05T00:00:00.000Z",
    "intervalEnd": "2025-10-06T00:00:00.000Z",
    "intervalType": "day"
  },
  "repository": "elizaos/eliza",
  "overview": "From 2025-10-05 to 2025-10-06, elizaos/eliza had 2 new PRs (3 merged), 0 new issues, and 6 active contributors.",
  "topIssues": [],
  "topPRs": [
    {
      "id": "PR_kwDOMT5cIs6rxG2c",
      "title": "feat: Add mentionContext interface and improve shouldRespond logic",
      "author": "standujar",
      "number": 6030,
      "body": "# Relates to\r\n\r\nIssue discussing the need for platform-agnostic mention detection\r\n\r\n# Risks\r\n\r\n**Medium Risk**\r\n- Changes core message flow logic in bootstrap\r\n- Modifies shouldRespond template and provider\r\n- Affects LLM decision-making for response behavior\r\n- Impacts all platforms that depend on bootstrap logic\r\n\r\n# Background\r\n\r\n## What does this PR do?\r\n\r\nThis PR introduces a platform-agnostic mention detection system through the `MentionContext` interface:\r\n\r\n**Core Changes:**\r\n- Adds `MentionContext` interface to `Content` type in `packages/core/src/types/primitives.ts`\r\n  - Provides universal structure for platform mention metadata (isMention, isReply, isThread)\r\n  - Enables platforms to provide facts without implementing detection logic\r\n\r\n- Enhances `shouldRespondTemplate` in `packages/core/src/prompts.ts`\r\n  - Adds explicit \"IMPORTANT RULES FOR RESPONDING\" section\r\n  - Clarifies \"talking TO\" vs \"talking ABOUT\" distinction\r\n  - Instructs LLM to handle text mentions, typos, and variations naturally\r\n\r\n- Enriches `shouldRespondProvider` in `packages/plugin-bootstrap/src/providers/shouldRespond.ts`\r\n  - Adds 10+ examples covering edge cases (direct mentions, typos, indirect questions, references)\r\n  - Teaches LLM to distinguish interpellation from mere references\r\n\r\n- Modifies `shouldBypassShouldRespond` in `packages/plugin-bootstrap/src/index.ts`\r\n  - Accepts optional `mentionContext` parameter\r\n  - Implements fast-path optimization: skips LLM call for platform-native mentions (@mentions, replies)\r\n  - Saves tokens and improves response time for obvious mentions\r\n\r\n**Key Architecture Principles:**\r\n- Bootstrap remains 100% platform-agnostic (no Discord/Telegram/etc specific logic)\r\n- Platforms provide FACTS only via mentionContext\r\n- LLM analyzes context and makes intelligent decisions\r\n- Fast path for platform mentions, LLM path for text analysis\r\n\r\n## What kind of change is this?\r\n\r\n- [x] Features (adds platform-agnostic MentionContext interface)\r\n- [x] Improvements (refactors mention detection to be more intelligent and extensible)\r\n\r\n# Documentation changes needed?\r\n\r\n- [x] My changes require a change to the project documentation\r\n- Documentation needed for:\r\n  - `MentionContext` interface usage guide for plugin developers\r\n  - How platforms should populate mentionContext metadata\r\n  - Fast-path optimization behavior explanation\r\n\r\n# Testing\r\n\r\n## Where should a reviewer start?\r\n\r\n1. Review the `MentionContext` interface in `packages/core/src/types/primitives.ts`\r\n2. Check the enhanced prompt in `packages/core/src/prompts.ts` (search for \"IMPORTANT RULES FOR RESPONDING\")\r\n3. Review enriched examples in `packages/plugin-bootstrap/src/providers/shouldRespond.ts`\r\n4. Check `shouldBypassShouldRespond` changes in `packages/plugin-bootstrap/src/index.ts`\r\n5. Run test suites to verify coverage\r\n\r\n## Detailed testing steps\r\n\r\n**Automated Tests:**\r\n\r\n```bash\r\n# Core prompts tests (8 tests)\r\nbun test packages/core/src/__tests__/prompts.test.ts\r\n\r\n# Bootstrap logic tests (21 tests, 6 new for mentionContext)\r\nbun test packages/plugin-bootstrap/src/__tests__/logic.test.ts\r\n```\r\n\r\n**Test Coverage:**\r\n- ✅ `packages/core/src/__tests__/prompts.test.ts`\r\n  - Verifies shouldRespondTemplate contains new \"IMPORTANT RULES FOR RESPONDING\" section\r\n  - Checks for \"talking TO\" vs \"talking ABOUT\" instructions\r\n  - **Result: 8 pass, 0 fail**\r\n\r\n- ✅ `packages/plugin-bootstrap/src/__tests__/logic.test.ts`\r\n  - New describe block: \"shouldBypassShouldRespond with mentionContext\"\r\n  - 6 new tests covering:\r\n    1. DM channel bypass\r\n    2. Platform mention bypass (isMention=true)\r\n    3. Reply to bot bypass (isReply=true)\r\n    4. No bypass for regular messages\r\n    5. client_chat source bypass\r\n    6. Platform agnostic behavior (discord, telegram, twitter, slack)\r\n  - **Result: 21 pass, 0 fail**\r\n\r\n**Manual Integration Testing:**\r\n- Platforms implementing mentionContext will need to test with real messages\r\n- Verify LLM correctly distinguishes \"Hey BotName, help me\" (RESPOND) vs \"BotName's code is great\" (IGNORE)\r\n- Verify fast-path works for @mentions (no unnecessary LLM calls)\r\n\r\n## Screenshots\r\n\r\nN/A - This is core infrastructure with no UI changes\r\n\r\n# Deploy Notes\r\n\r\n## Deployment instructions\r\n\r\n**Standard deployment:**\r\n1. Merge this PR to main\r\n2. Release as v1.6.2 (or next minor version)\r\n3. No breaking changes - fully backward compatible\r\n4. Platforms can adopt mentionContext incrementally (optional parameter)\r\n\r\n**For platform plugin developers:**\r\n- Existing plugins continue to work without changes\r\n- To adopt mentionContext, populate it in message content before passing to bootstrap\r\n- Reference Discord plugin implementation as example\r\n\r\n**No database changes required**\r\n",
      "repository": "elizaos/eliza",
      "createdAt": "2025-10-02T13:20:09Z",
      "mergedAt": "2025-10-05T11:20:06Z",
      "additions": 295,
      "deletions": 167
    },
    {
      "id": "PR_kwDOMT5cIs6sIs7Y",
      "title": "feat(plugin-sql): add offset parameter to getMemories for database-le…",
      "author": "0xbbjoker",
      "number": 6032,
      "body": "<!-- CURSOR_SUMMARY -->\n> [!NOTE]\n> Adds an optional offset to getMemories for pagination, applies limit/offset in SQL, validates non-negative values, and adds integration tests covering paging and edge cases.\n> \n> - **Core**:\n>   - Add `offset?: number` to `getMemories` in `packages/core/src/database.ts` and `packages/core/src/types/database.ts`.\n> - **Plugin SQL**:\n>   - Implement `offset` handling in `BaseDrizzleAdapter.getMemories` with validation (`offset >= 0`).\n>   - Apply conditional `.limit()` and `.offset()` to the base query; keep ordering by `createdAt` desc.\n>   - Update JSDoc to document `offset`.\n> - **Tests**:\n>   - Add integration tests for pagination using `count` + `offset`, offset-only, large offset, zero/absent offset behavior, negative offset rejection, and consistency with `countMemories`.\n> \n> <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 6961feff4ddcef83c12168fa4730e50afe731105. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>\n<!-- /CURSOR_SUMMARY -->\n\n<!-- This is an auto-generated comment: release notes by coderabbit.ai -->\n\n## Summary by CodeRabbit\n\n- New Features\n  - Added optional offset-based pagination to memory retrieval for more precise paging.\n\n- Tests\n  - Introduced comprehensive integration tests covering pagination (count/offset combinations), large-offset edge cases, non-overlapping pages, and partial update integrity.\n\n- Chores\n  - Added a new plugin submodule for knowledge functionality.\n  - Updated the knowledge plugin submodule reference.\n\n- Documentation\n  - Updated parameter docs to include the new offset option in memory retrieval.\n\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
      "repository": "elizaos/eliza",
      "createdAt": "2025-10-05T10:10:31Z",
      "mergedAt": "2025-10-05T11:38:35Z",
      "additions": 182,
      "deletions": 3
    },
    {
      "id": "PR_kwDOMT5cIs6sJnDZ",
      "title": "chore: modernize renovate configuration and add preset for plugins",
      "author": "standujar",
      "number": 6033,
      "body": "\r\n<!-- This is an auto-generated comment: release notes by coderabbit.ai -->\r\n\r\n## Summary by CodeRabbit\r\n\r\n- Chores\r\n  - Added a shared Renovate configuration preset to standardize dependency updates across plugins, with grouped rules for core dependencies, TypeScript, linting, and build tools.\r\n  - Overhauled Renovate setup: switched to recommended base and introduced descriptive groups (React, Testing, Tailwind, Tauri, Drizzle ORM, Radix UI), consolidating internal package handling.\r\n  - Increased update cadence and PR limits (daily schedule, higher caps), enabled a dependency dashboard with semantic commit settings; automerge remains disabled.\r\n\r\n<!-- end of auto-generated comment: release notes by coderabbit.ai -->",
      "repository": "elizaos/eliza",
      "createdAt": "2025-10-05T16:26:18Z",
      "mergedAt": "2025-10-08T08:08:09Z",
      "additions": 98,
      "deletions": 13
    },
    {
      "id": "PR_kwDOMT5cIs6qrZTE",
      "title": "chore: fix typo in comment",
      "author": "letreturn",
      "number": 6009,
      "body": "<!-- Use this template by filling in information and copying and pasting relevant items out of the HTML comments. -->\r\n\r\n# Relates to\r\n\r\n<!-- LINK TO ISSUE OR TICKET -->\r\n\r\n<!-- This risks section must be filled out before the final review and merge. -->\r\n\r\n# Risks\r\n\r\n<!--\r\nLow, medium, large. List what kind of risks and what could be affected.\r\n-->\r\n\r\n# Background\r\n\r\n## What does this PR do?\r\n\r\nfix typo in comment and format the code\r\n\r\n## What kind of change is this?\r\n\r\n<!--\r\nBug fixes (non-breaking change which fixes an issue)\r\nImprovements (misc. changes to existing features)\r\nFeatures (non-breaking change which adds functionality)\r\nUpdates (new versions of included code)\r\n-->\r\n\r\n<!-- This \"Why\" section is most relevant if there are no linked issues explaining why. If there is a related issue, it might make sense to skip this why section. -->\r\n<!--\r\n## Why are we doing this? Any context or related work?\r\n-->\r\n\r\n# Documentation changes needed?\r\n\r\n<!--\r\nMy changes do not require a change to the project documentation.\r\nMy changes require a change to the project documentation.\r\nIf documentation change is needed: I have updated the documentation accordingly.\r\n-->\r\n\r\n<!-- Please show how you tested the PR. This will really help if the PR needs to be retested and probably help the PR get merged quicker. -->\r\n\r\n# Testing\r\n\r\n## Where should a reviewer start?\r\n\r\n## Detailed testing steps\r\n\r\n<!--\r\nNone: Automated tests are acceptable.\r\n-->\r\n\r\n<!--\r\n- As [anon/admin], go to [link]\r\n  - [do action]\r\n  - verify [result]\r\n-->\r\n\r\n<!-- If there is a UI change, please include before and after screenshots or videos. This will speed up PRs being merged. It is extra nice to annotate screenshots with arrows or boxes pointing out the differences. -->\r\n<!--\r\n## Screenshots\r\n### Before\r\n### After\r\n-->\r\n\r\n<!-- If there is anything about the deployment, please make a note. -->\r\n<!--\r\n# Deploy Notes\r\n-->\r\n\r\n<!--  Copy and paste command line output. -->\r\n<!--\r\n## Database changes\r\n-->\r\n\r\n<!--  Please specify deploy instructions if there is something more than the automated steps. -->\r\n<!--\r\n## Deployment instructions\r\n-->\r\n\r\n<!-- If you are on Discord, please join https://discord.gg/ai16z and state your Discord username here for the contributor role and join us in #development-feed -->\r\n<!--\r\n## Discord username\r\n\r\n-->\r\n",
      "repository": "elizaos/eliza",
      "createdAt": "2025-09-26T10:18:10Z",
      "mergedAt": null,
      "additions": 17,
      "deletions": 17
    },
    {
      "id": "PR_kwDOMT5cIs6qe-Lf",
      "title": "docs: fix typo",
      "author": "viktorking7",
      "number": 6000,
      "body": "Occassionally -> Occasionally\r\n\r\n\r\n",
      "repository": "elizaos/eliza",
      "createdAt": "2025-09-25T11:12:13Z",
      "mergedAt": "2025-10-05T11:40:34Z",
      "additions": 1,
      "deletions": 1
    }
  ],
  "codeChanges": {
    "additions": 485,
    "deletions": 178,
    "files": 13,
    "commitCount": 13
  },
  "completedItems": [
    {
      "title": "docs: fix typo",
      "prNumber": 6000,
      "type": "bugfix",
      "body": "Occassionally -> Occasionally\r\n\r\n\r\n",
      "files": [
        "packages/cli/src/commands/scenario/docs/README.md"
      ]
    },
    {
      "title": "feat: Add mentionContext interface and improve shouldRespond logic",
      "prNumber": 6030,
      "type": "feature",
      "body": "# Relates to\r\n\r\nIssue discussing the need for platform-agnostic mention detection\r\n\r\n# Risks\r\n\r\n**Medium Risk**\r\n- Changes core message flow logic in bootstrap\r\n- Modifies shouldRespond template and provider\r\n- Affects LLM decision-making f",
      "files": [
        "bun.lock",
        "packages/core/src/__tests__/prompts.test.ts",
        "packages/core/src/prompts.ts",
        "packages/core/src/types/primitives.ts",
        "packages/plugin-bootstrap/src/__tests__/logic.test.ts",
        "packages/plugin-bootstrap/src/index.ts",
        "packages/plugin-bootstrap/src/providers/shouldRespond.ts",
        "packages/plugin-bootstrap/src/providers/index.ts"
      ]
    },
    {
      "title": "feat(plugin-sql): add offset parameter to getMemories for database-le…",
      "prNumber": 6032,
      "type": "feature",
      "body": "<!-- CURSOR_SUMMARY -->\n> [!NOTE]\n> Adds an optional offset to getMemories for pagination, applies limit/offset in SQL, validates non-negative values, and adds integration tests covering paging and edge cases.\n> \n> - **Core**:\n>   - Add `of",
      "files": [
        "packages/core/src/database.ts",
        "packages/core/src/types/database.ts",
        "packages/plugin-sql/src/__tests__/integration/memory.test.ts",
        "packages/plugin-sql/src/base.ts"
      ]
    }
  ],
  "topContributors": [
    {
      "username": "standujar",
      "avatarUrl": "https://avatars.githubusercontent.com/u/16385918?u=718bdcd1585be8447bdfffb8c11ce249baa7532d&v=4",
      "totalScore": 51.4831895621705,
      "prScore": 51.1431895621705,
      "issueScore": 0,
      "reviewScore": 0,
      "commentScore": 0.33999999999999997,
      "summary": "standujar: Primarily focused on maintenance and configuration, opening 15 PRs across various `elizaos-plugins` repositories and `elizaos/eliza` to add or modernize Renovate configurations, demonstrating a concerted effort to streamline dependency management. This work involved modifying 19 configuration files with 17 commits, indicating a broad impact on project infrastructure."
    },
    {
      "username": "0xbbjoker",
      "avatarUrl": "https://avatars.githubusercontent.com/u/54844437?u=90fe1762420de6ad493a1c1582f1f70c0d87d8e2&v=4",
      "totalScore": 41.119493347426406,
      "prScore": 40.7794933474264,
      "issueScore": 0,
      "reviewScore": 0,
      "commentScore": 0.33999999999999997,
      "summary": "0xbbjoker: Focused on feature development and bug fixes, notably adding an offset parameter to `getMemories` in elizaos/eliza#6032 (+516/-209 lines), demonstrating a primary focus on code and test modifications."
    },
    {
      "username": "wtfsayo",
      "avatarUrl": "https://avatars.githubusercontent.com/u/82053242?u=98209a1f10456f42d4d2fa71db4d5bf4a672cbc3&v=4",
      "totalScore": 6,
      "prScore": 0,
      "issueScore": 0,
      "reviewScore": 6,
      "commentScore": 0,
      "summary": "wtfsayo: Today, wtfsayo engaged in substantial code modifications across 262 files, contributing 7 commits with a primary focus on other work (57%), bugfix work (29%), and feature work (14%), and also provided one change request review."
    }
  ],
  "newPRs": 2,
  "mergedPRs": 3,
  "newIssues": 0,
  "closedIssues": 0,
  "activeContributors": 6
}