@agent-native/core 0.127.3 → 0.128.1

package/dist/org/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/org/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,aAAa,GAEd,MAAM,IAAI,CAAC;AAEZ,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,UAAU,GAAG,GAAG,gBAAgB,MAAM,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,aAAa,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAE5E,OAAO,KAAK,EAAE,QAAa,EAAE,EAAE;QAC7B,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;QAExB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE/B,UAAU;QACV,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,KAAK,EAClB,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC/B,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CACH,CAAC;QAEF,sEAAsE;QACtE,mEAAmE;QACnE,+DAA+D;QAC/D,6BAA6B;QAC7B,EAAE;QACF,iEAAiE;QACjE,6DAA6D;QAC7D,gEAAgE;QAChE,mEAAmE;QACnE,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,UAAU,EACvB,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;YAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAChC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;oBACrB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;gBACzC,CAAC;gBACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YACD,uBAAuB;YACvB,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;oBACrB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;gBACzC,CAAC;gBACD,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC;YACD,kBAAkB;YAClB,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CACH,CAAC;QAEF,2DAA2D;QAC3D,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,cAAc,EAC3B,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;YAClD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAChC,IAAI,MAAM,KAAK,KAAK;oBAAE,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;gBAC3D,IAAI,MAAM,KAAK,MAAM;oBAAE,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;gBAC7D,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,sBAAsB;YACtB,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;oBACtB,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;gBACzC,CAAC;gBACD,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;YACxC,CAAC;YACD,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAChC,CAAC,CAAC,CACH,CAAC;QAEF,uBAAuB;QACvB,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,iBAAiB,EAC9B,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,MAAM,EAAE,CAAC;gBAChC,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CACH,CAAC;QAEF,iEAAiE;QACjE,yEAAyE;QACzE,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,kBAAkB,EAC/B,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,MAAM,EAAE,CAAC;gBAChC,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CACH,CAAC;QAEF,sEAAsE;QACtE,oEAAoE;QACpE,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,qBAAqB,EAClC,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,MAAM,EAAE,CAAC;gBAChC,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC,CAAC,CACH,CAAC;QAEF,oEAAoE;QACpE,oEAAoE;QACpE,oEAAoE;QACpE,wCAAwC;QACxC,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,aAAa,EAC1B,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;YAClD,kEAAkE;YAClE,gEAAgE;YAChE,uDAAuD;YACvD,IACE,IAAI,KAAK,OAAO;gBAChB,IAAI,KAAK,QAAQ;gBACjB,IAAI,KAAK,UAAU;gBACnB,IAAI,KAAK,WAAW,EACpB,CAAC;gBACD,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK;gBAAE,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;YACrE,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC/B,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC,CAAC,CACH,CAAC;QAEF,cAAc;QACd,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,SAAS,EACtB,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC/B,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC,CACH,CAAC;QAEF,cAAc;QACd,GAAG,CAAC,GAAG,CACL,GAAG,UAAU,SAAS,EACtB,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC/B,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;YACzC,CAAC;YACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC,CACH,CAAC;QAEF,wEAAwE;QACxE,0CAA0C;QAC1C,GAAG,CAAC,GAAG,CACL,UAAU,EACV,kBAAkB,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;YAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACtD,IAAI,MAAM,KAAK,OAAO;gBAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,MAAM,KAAK,QAAQ;gBAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACxD,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC9B,OAAO,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;QACzC,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB,eAAe,EAAE,CAAC","sourcesContent":["import {\n  defineEventHandler,\n  setResponseStatus,\n  getMethod,\n  getRequestURL,\n  type H3Event,\n} from \"h3\";\n\nimport { runMigrations } from \"../db/migrations.js\";\nimport {\n  awaitBootstrap,\n  getH3App,\n  FRAMEWORK_PREFIX,\n  markDefaultPluginProvided,\n} from \"../server/framework-request-handler.js\";\nimport {\n  getMyOrgHandler,\n  createOrgHandler,\n  updateOrgHandler,\n  deleteOrgHandler,\n  switchOrgHandler,\n  listMembersHandler,\n  removeMemberHandler,\n  changeMemberRoleHandler,\n  listInvitationsHandler,\n  createInvitationHandler,\n  acceptInvitationHandler,\n  joinByDomainHandler,\n  setDomainHandler,\n  revealA2ASecretHandler,\n  setA2ASecretHandler,\n  syncA2ASecretHandler,\n  receiveA2ASecretHandler,\n} from \"./handlers.js\";\nimport { ORG_MIGRATIONS } from \"./migrations.js\";\n\ntype NitroPluginDef = (nitroApp: any) => void | Promise<void>;\n\nconst ORG_PREFIX = `${FRAMEWORK_PREFIX}/org`;\n\n/**\n * Mounts the org REST routes under `/_agent-native/org/*` and runs the org\n * module's migrations.\n *\n * Routes:\n *   GET    /_agent-native/org/me                          — current user's active org + invites\n *   POST   /_agent-native/org                             — create organization\n *   PATCH  /_agent-native/org                             — rename organization (owner/admin)\n *   DELETE /_agent-native/org                             — delete organization (owner only)\n *   PUT    /_agent-native/org/switch                      — switch active org\n *   GET    /_agent-native/org/members                     — list members of active org\n *   DELETE /_agent-native/org/members/:email              — remove member (owner/admin only)\n *   GET    /_agent-native/org/invitations                 — list pending invites\n *   POST   /_agent-native/org/invitations                 — invite by email\n *   POST   /_agent-native/org/invitations/:id/accept      — accept an invitation\n *   POST   /_agent-native/org/join-by-domain              — join org via email domain match\n *   PUT    /_agent-native/org/domain                      — set/clear allowed email domain (owner/admin)\n *   GET    /_agent-native/org/a2a-secret                  — reveal A2A secret on demand (owner/admin)\n *   PUT    /_agent-native/org/a2a-secret                  — regenerate or set A2A secret (owner/admin)\n *   POST   /_agent-native/org/a2a-secret/sync             — push secret to all connected apps (owner/admin)\n *   POST   /_agent-native/org/a2a-secret/receive          — accept a peer's secret push (JWT-auth, no session)\n */\nexport function createOrgPlugin(): NitroPluginDef {\n  const migrate = runMigrations(ORG_MIGRATIONS, { table: \"_org_migrations\" });\n\n  return async (nitroApp: any) => {\n    markDefaultPluginProvided(nitroApp, \"org\");\n    await awaitBootstrap(nitroApp);\n    await migrate(nitroApp);\n\n    const app = getH3App(nitroApp);\n\n    // GET /me\n    app.use(\n      `${ORG_PREFIX}/me`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"GET\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return getMyOrgHandler(event);\n      }),\n    );\n\n    // /members, /members/:email, /members/:email/role — dispatch by path-\n    // tail + method in a single handler so H3's prefix-based `app.use`\n    // doesn't route a DELETE for /members/alice@example.com to the\n    // GET-only /members handler.\n    //\n    // NOTE: the framework request handler (packages/core/src/server/\n    // framework-request-handler.ts) strips the mount prefix from\n    // event.url.pathname before calling the handler, so inside here\n    // `url.pathname` is ALREADY the tail relative to this mount point.\n    app.use(\n      `${ORG_PREFIX}/members`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        const method = getMethod(event);\n        if (tail === \"\" || tail === \"/\") {\n          if (method !== \"GET\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return listMembersHandler(event);\n        }\n        // Tail is /:email/role\n        if (/^\\/[^/]+\\/role\\/?$/.test(tail)) {\n          if (method !== \"PUT\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return changeMemberRoleHandler(event);\n        }\n        // Tail is /:email\n        if (method !== \"DELETE\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return removeMemberHandler(event);\n      }),\n    );\n\n    // /invitations and /invitations/:id/accept — same pattern.\n    app.use(\n      `${ORG_PREFIX}/invitations`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        const method = getMethod(event);\n        if (tail === \"\" || tail === \"/\") {\n          if (method === \"GET\") return listInvitationsHandler(event);\n          if (method === \"POST\") return createInvitationHandler(event);\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        // Tail is /:id/accept\n        if (/^\\/[^/]+\\/accept\\/?$/.test(tail)) {\n          if (method !== \"POST\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return acceptInvitationHandler(event);\n        }\n        setResponseStatus(event, 404);\n        return { error: \"Not found\" };\n      }),\n    );\n\n    // POST /join-by-domain\n    app.use(\n      `${ORG_PREFIX}/join-by-domain`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"POST\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return joinByDomainHandler(event);\n      }),\n    );\n\n    // POST /a2a-secret/sync — must mount BEFORE /a2a-secret since h3\n    // matches by prefix. Pushes the org's A2A secret to every connected app.\n    app.use(\n      `${ORG_PREFIX}/a2a-secret/sync`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"POST\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return syncA2ASecretHandler(event);\n      }),\n    );\n\n    // POST /a2a-secret/receive — must mount BEFORE /a2a-secret. Accepts a\n    // peer's secret push; auth is JWT-based (see auth guard exemption).\n    app.use(\n      `${ORG_PREFIX}/a2a-secret/receive`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"POST\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return receiveA2ASecretHandler(event);\n      }),\n    );\n\n    // PUT /a2a-secret — must mount AFTER /a2a-secret/sync and /receive.\n    // Dispatches by tail to keep PUT semantics on the parent path while\n    // letting POST /a2a-secret return 405 (rather than silently routing\n    // to the more-specific handlers above).\n    app.use(\n      `${ORG_PREFIX}/a2a-secret`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        // The sub-route handlers above intercept these tails first; if we\n        // see them here it means the method didn't match (e.g. GET) and\n        // we should 405 rather than fall into the PUT handler.\n        if (\n          tail === \"/sync\" ||\n          tail === \"/sync/\" ||\n          tail === \"/receive\" ||\n          tail === \"/receive/\"\n        ) {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        if (getMethod(event) === \"GET\") return revealA2ASecretHandler(event);\n        if (getMethod(event) !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return setA2ASecretHandler(event);\n      }),\n    );\n\n    // PUT /domain\n    app.use(\n      `${ORG_PREFIX}/domain`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return setDomainHandler(event);\n      }),\n    );\n\n    // PUT /switch\n    app.use(\n      `${ORG_PREFIX}/switch`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return switchOrgHandler(event);\n      }),\n    );\n\n    // POST / (create) + PATCH / (rename) + DELETE / (delete) — mounted last\n    // so the more specific routes match first\n    app.use(\n      ORG_PREFIX,\n      defineEventHandler(async (event: H3Event) => {\n        const method = getMethod(event);\n        if (method === \"POST\") return createOrgHandler(event);\n        if (method === \"PATCH\") return updateOrgHandler(event);\n        if (method === \"DELETE\") return deleteOrgHandler(event);\n        setResponseStatus(event, 405);\n        return { error: \"Method not allowed\" };\n      }),\n    );\n  };\n}\n\n/**\n * Default org plugin — mount with no configuration needed.\n *\n * Auto-mounted by the framework when a template doesn't ship `server/plugins/org.ts`.\n * To override, create your own plugin file using `createOrgPlugin()` or a\n * completely custom implementation.\n */\nexport const defaultOrgPlugin: NitroPluginDef = createOrgPlugin();\n"]}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/org/plugin.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  defineEventHandler,\n  setResponseStatus,\n  getMethod,\n  getRequestURL,\n  type H3Event,\n} from \"h3\";\n\nimport { runMigrations } from \"../db/migrations.js\";\nimport {\n  awaitBootstrap,\n  getH3App,\n  FRAMEWORK_PREFIX,\n  markDefaultPluginProvided,\n} from \"../server/framework-request-handler.js\";\nimport {\n  listAppRolesHandler,\n  setAppRoleHandler,\n} from \"./app-roles-handlers.js\";\nimport {\n  getMyOrgHandler,\n  createOrgHandler,\n  updateOrgHandler,\n  deleteOrgHandler,\n  switchOrgHandler,\n  listMembersHandler,\n  removeMemberHandler,\n  changeMemberRoleHandler,\n  listInvitationsHandler,\n  createInvitationHandler,\n  acceptInvitationHandler,\n  joinByDomainHandler,\n  setDomainHandler,\n  revealA2ASecretHandler,\n  setA2ASecretHandler,\n  syncA2ASecretHandler,\n  receiveA2ASecretHandler,\n} from \"./handlers.js\";\nimport { ORG_MIGRATIONS } from \"./migrations.js\";\n\ntype NitroPluginDef = (nitroApp: any) => void | Promise<void>;\n\nconst ORG_PREFIX = `${FRAMEWORK_PREFIX}/org`;\n\n/**\n * Mounts the org REST routes under `/_agent-native/org/*` and runs the org\n * module's migrations.\n *\n * Routes:\n *   GET    /_agent-native/org/me                          — current user's active org + invites\n *   POST   /_agent-native/org                             — create organization\n *   PATCH  /_agent-native/org                             — rename organization (owner/admin)\n *   DELETE /_agent-native/org                             — delete organization (owner only)\n *   PUT    /_agent-native/org/switch                      — switch active org\n *   GET    /_agent-native/org/members                     — list members of active org\n *   DELETE /_agent-native/org/members/:email              — remove member (owner/admin only)\n *   GET    /_agent-native/org/app-roles?appId=X           — app role vocabulary + assignments\n *   PUT    /_agent-native/org/app-roles/:email            — assign/clear app role (owner/admin)\n *   GET    /_agent-native/org/invitations                 — list pending invites\n *   POST   /_agent-native/org/invitations                 — invite by email\n *   POST   /_agent-native/org/invitations/:id/accept      — accept an invitation\n *   POST   /_agent-native/org/join-by-domain              — join org via email domain match\n *   PUT    /_agent-native/org/domain                      — set/clear allowed email domain (owner/admin)\n *   GET    /_agent-native/org/a2a-secret                  — reveal A2A secret on demand (owner/admin)\n *   PUT    /_agent-native/org/a2a-secret                  — regenerate or set A2A secret (owner/admin)\n *   POST   /_agent-native/org/a2a-secret/sync             — push secret to all connected apps (owner/admin)\n *   POST   /_agent-native/org/a2a-secret/receive          — accept a peer's secret push (JWT-auth, no session)\n */\nexport function createOrgPlugin(): NitroPluginDef {\n  const migrate = runMigrations(ORG_MIGRATIONS, { table: \"_org_migrations\" });\n\n  return async (nitroApp: any) => {\n    markDefaultPluginProvided(nitroApp, \"org\");\n    await awaitBootstrap(nitroApp);\n    await migrate(nitroApp);\n\n    const app = getH3App(nitroApp);\n\n    // GET /me\n    app.use(\n      `${ORG_PREFIX}/me`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"GET\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return getMyOrgHandler(event);\n      }),\n    );\n\n    // /app-roles and /app-roles/:email — per-app role overlay on the roster.\n    app.use(\n      `${ORG_PREFIX}/app-roles`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        const method = getMethod(event);\n        if (tail === \"\" || tail === \"/\") {\n          if (method !== \"GET\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return listAppRolesHandler(event);\n        }\n        if (method !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return setAppRoleHandler(event);\n      }),\n    );\n\n    // /members, /members/:email, /members/:email/role — dispatch by path-\n    // tail + method in a single handler so H3's prefix-based `app.use`\n    // doesn't route a DELETE for /members/alice@example.com to the\n    // GET-only /members handler.\n    //\n    // NOTE: the framework request handler (packages/core/src/server/\n    // framework-request-handler.ts) strips the mount prefix from\n    // event.url.pathname before calling the handler, so inside here\n    // `url.pathname` is ALREADY the tail relative to this mount point.\n    app.use(\n      `${ORG_PREFIX}/members`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        const method = getMethod(event);\n        if (tail === \"\" || tail === \"/\") {\n          if (method !== \"GET\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return listMembersHandler(event);\n        }\n        // Tail is /:email/role\n        if (/^\\/[^/]+\\/role\\/?$/.test(tail)) {\n          if (method !== \"PUT\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return changeMemberRoleHandler(event);\n        }\n        // Tail is /:email\n        if (method !== \"DELETE\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return removeMemberHandler(event);\n      }),\n    );\n\n    // /invitations and /invitations/:id/accept — same pattern.\n    app.use(\n      `${ORG_PREFIX}/invitations`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        const method = getMethod(event);\n        if (tail === \"\" || tail === \"/\") {\n          if (method === \"GET\") return listInvitationsHandler(event);\n          if (method === \"POST\") return createInvitationHandler(event);\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        // Tail is /:id/accept\n        if (/^\\/[^/]+\\/accept\\/?$/.test(tail)) {\n          if (method !== \"POST\") {\n            setResponseStatus(event, 405);\n            return { error: \"Method not allowed\" };\n          }\n          return acceptInvitationHandler(event);\n        }\n        setResponseStatus(event, 404);\n        return { error: \"Not found\" };\n      }),\n    );\n\n    // POST /join-by-domain\n    app.use(\n      `${ORG_PREFIX}/join-by-domain`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"POST\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return joinByDomainHandler(event);\n      }),\n    );\n\n    // POST /a2a-secret/sync — must mount BEFORE /a2a-secret since h3\n    // matches by prefix. Pushes the org's A2A secret to every connected app.\n    app.use(\n      `${ORG_PREFIX}/a2a-secret/sync`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"POST\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return syncA2ASecretHandler(event);\n      }),\n    );\n\n    // POST /a2a-secret/receive — must mount BEFORE /a2a-secret. Accepts a\n    // peer's secret push; auth is JWT-based (see auth guard exemption).\n    app.use(\n      `${ORG_PREFIX}/a2a-secret/receive`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"POST\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return receiveA2ASecretHandler(event);\n      }),\n    );\n\n    // PUT /a2a-secret — must mount AFTER /a2a-secret/sync and /receive.\n    // Dispatches by tail to keep PUT semantics on the parent path while\n    // letting POST /a2a-secret return 405 (rather than silently routing\n    // to the more-specific handlers above).\n    app.use(\n      `${ORG_PREFIX}/a2a-secret`,\n      defineEventHandler(async (event: H3Event) => {\n        const tail = getRequestURL(event).pathname || \"/\";\n        // The sub-route handlers above intercept these tails first; if we\n        // see them here it means the method didn't match (e.g. GET) and\n        // we should 405 rather than fall into the PUT handler.\n        if (\n          tail === \"/sync\" ||\n          tail === \"/sync/\" ||\n          tail === \"/receive\" ||\n          tail === \"/receive/\"\n        ) {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        if (getMethod(event) === \"GET\") return revealA2ASecretHandler(event);\n        if (getMethod(event) !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return setA2ASecretHandler(event);\n      }),\n    );\n\n    // PUT /domain\n    app.use(\n      `${ORG_PREFIX}/domain`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return setDomainHandler(event);\n      }),\n    );\n\n    // PUT /switch\n    app.use(\n      `${ORG_PREFIX}/switch`,\n      defineEventHandler(async (event: H3Event) => {\n        if (getMethod(event) !== \"PUT\") {\n          setResponseStatus(event, 405);\n          return { error: \"Method not allowed\" };\n        }\n        return switchOrgHandler(event);\n      }),\n    );\n\n    // POST / (create) + PATCH / (rename) + DELETE / (delete) — mounted last\n    // so the more specific routes match first\n    app.use(\n      ORG_PREFIX,\n      defineEventHandler(async (event: H3Event) => {\n        const method = getMethod(event);\n        if (method === \"POST\") return createOrgHandler(event);\n        if (method === \"PATCH\") return updateOrgHandler(event);\n        if (method === \"DELETE\") return deleteOrgHandler(event);\n        setResponseStatus(event, 405);\n        return { error: \"Method not allowed\" };\n      }),\n    );\n  };\n}\n\n/**\n * Default org plugin — mount with no configuration needed.\n *\n * Auto-mounted by the framework when a template doesn't ship `server/plugins/org.ts`.\n * To override, create your own plugin file using `createOrgPlugin()` or a\n * completely custom implementation.\n */\nexport const defaultOrgPlugin: NitroPluginDef = createOrgPlugin();\n"]}

package/dist/org/schema.d.ts

@@ -217,6 +217,149 @@ export declare const orgMembers: import("drizzle-orm/sqlite-core").SQLiteTableWi
     };
     dialect: 'sqlite';
 }>;
+/**
+ * Per-app role assignments, keyed to an existing `org_members` row. An app role
+ * only narrows what a member may do inside one app; it never grants membership,
+ * and it never implies an org role.
+ */
+export declare const appMemberRoles: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "app_member_roles";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "app_member_roles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        orgId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "org_id";
+            tableName: "app_member_roles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        appId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "app_id";
+            tableName: "app_member_roles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        email: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "email";
+            tableName: "app_member_roles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        role: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "role";
+            tableName: "app_member_roles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        updatedBy: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_by";
+            tableName: "app_member_roles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number;
+        }>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "app_member_roles";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'sqlite';
+}>;
 export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
     name: "org_invitations";
     schema: undefined;

package/dist/org/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/org/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMrB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/org/schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQzB,CAAC"}

package/dist/org/schema.js

@@ -14,6 +14,20 @@ export const orgMembers = table("org_members", {
     role: text("role").notNull(),
     joinedAt: integer("joined_at").notNull(),
 });
+/**
+ * Per-app role assignments, keyed to an existing `org_members` row. An app role
+ * only narrows what a member may do inside one app; it never grants membership,
+ * and it never implies an org role.
+ */
+export const appMemberRoles = table("app_member_roles", {
+    id: text("id").primaryKey(),
+    orgId: text("org_id").notNull(),
+    appId: text("app_id").notNull(),
+    email: text("email").notNull(),
+    role: text("role").notNull(),
+    updatedBy: text("updated_by").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+});
 export const orgInvitations = table("org_invitations", {
     id: text("id").primaryKey(),
     orgId: text("org_id").notNull(),

package/dist/org/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/org/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,eAAe,EAAE;IAClD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE;IAC7C,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;CACzC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,EAAE;IACrD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;CACnB,CAAC,CAAC","sourcesContent":["import { table, text, integer } from \"../db/schema.js\";\n\nexport const organizations = table(\"organizations\", {\n  id: text(\"id\").primaryKey(),\n  name: text(\"name\").notNull(),\n  createdBy: text(\"created_by\").notNull(),\n  createdAt: integer(\"created_at\").notNull(),\n  allowedDomain: text(\"allowed_domain\"),\n  a2aSecret: text(\"a2a_secret\"),\n});\n\nexport const orgMembers = table(\"org_members\", {\n  id: text(\"id\").primaryKey(),\n  orgId: text(\"org_id\").notNull(),\n  email: text(\"email\").notNull(),\n  role: text(\"role\").notNull(),\n  joinedAt: integer(\"joined_at\").notNull(),\n});\n\nexport const orgInvitations = table(\"org_invitations\", {\n  id: text(\"id\").primaryKey(),\n  orgId: text(\"org_id\").notNull(),\n  email: text(\"email\").notNull(),\n  invitedBy: text(\"invited_by\").notNull(),\n  createdAt: integer(\"created_at\").notNull(),\n  status: text(\"status\").notNull(),\n  role: text(\"role\"),\n});\n"]}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/org/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,eAAe,EAAE;IAClD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,aAAa,EAAE,IAAI,CAAC,gBAAgB,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE;IAC7C,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;CACzC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,kBAAkB,EAAE;IACtD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,iBAAiB,EAAE;IACrD,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAC/B,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE;IAC9B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE;IAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;CACnB,CAAC,CAAC","sourcesContent":["import { table, text, integer } from \"../db/schema.js\";\n\nexport const organizations = table(\"organizations\", {\n  id: text(\"id\").primaryKey(),\n  name: text(\"name\").notNull(),\n  createdBy: text(\"created_by\").notNull(),\n  createdAt: integer(\"created_at\").notNull(),\n  allowedDomain: text(\"allowed_domain\"),\n  a2aSecret: text(\"a2a_secret\"),\n});\n\nexport const orgMembers = table(\"org_members\", {\n  id: text(\"id\").primaryKey(),\n  orgId: text(\"org_id\").notNull(),\n  email: text(\"email\").notNull(),\n  role: text(\"role\").notNull(),\n  joinedAt: integer(\"joined_at\").notNull(),\n});\n\n/**\n * Per-app role assignments, keyed to an existing `org_members` row. An app role\n * only narrows what a member may do inside one app; it never grants membership,\n * and it never implies an org role.\n */\nexport const appMemberRoles = table(\"app_member_roles\", {\n  id: text(\"id\").primaryKey(),\n  orgId: text(\"org_id\").notNull(),\n  appId: text(\"app_id\").notNull(),\n  email: text(\"email\").notNull(),\n  role: text(\"role\").notNull(),\n  updatedBy: text(\"updated_by\").notNull(),\n  updatedAt: integer(\"updated_at\").notNull(),\n});\n\nexport const orgInvitations = table(\"org_invitations\", {\n  id: text(\"id\").primaryKey(),\n  orgId: text(\"org_id\").notNull(),\n  email: text(\"email\").notNull(),\n  invitedBy: text(\"invited_by\").notNull(),\n  createdAt: integer(\"created_at\").notNull(),\n  status: text(\"status\").notNull(),\n  role: text(\"role\"),\n});\n"]}

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -75,8 +75,9 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         user: "user";
     }>>;
 }, z.core.$strip>>, {
-    id?: undefined;
     deleted?: undefined;
+    id?: undefined;
+    provider?: undefined;
     found?: undefined;
     message?: undefined;
     providers: {
@@ -89,13 +90,12 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
-    provider?: undefined;
     registered?: undefined;
     label?: undefined;
 } | {
+    deleted?: undefined;
     count?: undefined;
     id?: undefined;
-    deleted?: undefined;
     message?: undefined;
     providers?: undefined;
     found: boolean;
@@ -103,31 +103,31 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     registered?: undefined;
     label?: undefined;
 } | {
-    count?: undefined;
     deleted?: undefined;
+    count?: undefined;
+    provider?: undefined;
     message?: undefined;
     providers?: undefined;
-    provider?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
 } | {
     count?: undefined;
+    provider?: undefined;
     found?: undefined;
     message?: undefined;
     providers?: undefined;
-    provider?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
 } | {
-    count?: undefined;
     deleted?: undefined;
+    count?: undefined;
+    provider?: undefined;
     found?: undefined;
     providers?: undefined;
-    provider?: undefined;
     registered: boolean;
     id: string;
     label: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -312,7 +312,6 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         scope?: "org" | "user" | undefined;
     }, {
         id?: undefined;
-        message?: undefined;
         deleted?: undefined;
         found?: undefined;
         providers: {
@@ -328,9 +327,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         provider?: undefined;
         registered?: undefined;
         label?: undefined;
+        message?: undefined;
     } | {
         id?: undefined;
-        message?: undefined;
         deleted?: undefined;
         count?: undefined;
         providers?: undefined;
@@ -338,8 +337,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
+    } | {
         deleted?: undefined;
         count?: undefined;
         providers?: undefined;
@@ -348,8 +347,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         id: string;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
+    } | {
         found?: undefined;
         count?: undefined;
         providers?: undefined;
@@ -358,6 +357,7 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         id: string;
         registered?: undefined;
         label?: undefined;
+        message?: undefined;
     } | {
         deleted?: undefined;
         found?: undefined;

package/dist/scripts/docs/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/scripts/docs/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyNH,wBAA8B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5E"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/scripts/docs/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAwOH,wBAA8B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2D5E"}

package/dist/scripts/docs/search.js

@@ -21,6 +21,19 @@ function getDocsRoot() {
 function getDocsDir() {
     return path.join(getDocsRoot(), "content");
 }
+/**
+ * Bundled serverless deploys carry the runtime agent bundle but not the
+ * framework doc pages, so a miss there means "not deployed", not "no such
+ * doc". Say which, or the agent concludes a documented API does not exist.
+ */
+function logMissingFrameworkDocsNote() {
+    if (fs.existsSync(getDocsDir()))
+        return;
+    console.log("\nNote: bundled framework doc pages are not deployed here (only this " +
+        "app's AGENTS.md and skills are). A miss above does not mean the page " +
+        "does not exist — check the framework docs another way before concluding " +
+        "an API is missing.");
+}
 function parseFrontmatter(raw) {
     const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
     if (!match)
@@ -210,6 +223,7 @@ Options:
         if (!doc) {
             console.log(`Doc not found: ${parsed.slug}`);
             console.log(`Available: ${docs.map((d) => d.slug).join(", ")}`);
+            logMissingFrameworkDocsNote();
             return;
         }
         console.log(`# ${doc.title}\n`);
@@ -222,6 +236,7 @@ Options:
         const results = await searchDocs(parsed.query);
         if (results.length === 0) {
             console.log(`No docs found matching "${parsed.query}".`);
+            logMissingFrameworkDocsNote();
             return;
         }
         console.log(`Found ${results.length} doc(s) matching "${parsed.query}":\n`);

package/dist/scripts/docs/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/scripts/docs/search.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Core script: docs-search\n *\n * Search and read agent-native framework documentation.\n * Docs are bundled in @agent-native/core so they're always the right version.\n *\n * Usage:\n *   pnpm action docs-search --query \"actions\"\n *   pnpm action docs-search --slug authentication\n *   pnpm action docs-search --list\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { parseArgs } from \"../utils.js\";\n\ninterface DocMeta {\n  slug: string;\n  title: string;\n  description: string;\n}\n\ninterface DocFull extends DocMeta {\n  body: string;\n}\n\nfunction getDocsRoot(): string {\n  // Resolve from the package root:\n  //   src/scripts/docs/search.ts -> docs/\n  //   dist/scripts/docs/search.js -> docs/\n  return path.resolve(\n    path.dirname(new URL(import.meta.url).pathname),\n    \"../../../docs\",\n  );\n}\n\nfunction getDocsDir(): string {\n  return path.join(getDocsRoot(), \"content\");\n}\n\nfunction parseFrontmatter(raw: string): {\n  data: Record<string, string>;\n  body: string;\n} {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n([\\s\\S]*)$/);\n  if (!match) return { data: {}, body: raw };\n\n  const data: Record<string, string> = {};\n  for (const line of match[1].split(\"\\n\")) {\n    const m = line.match(/^(\\w+):\\s*\"?(.*?)\"?\\s*$/);\n    if (m) data[m[1]] = m[2];\n  }\n  return { data, body: match[2] };\n}\n\nfunction titleFromBody(body: string): string | null {\n  const heading = body.match(/^#\\s+(.+?)\\s*$/m);\n  return heading?.[1]?.trim() || null;\n}\n\nfunction isDocSourceFile(filename: string): boolean {\n  return filename.endsWith(\".mdx\") || filename.endsWith(\".md\");\n}\n\nfunction docSourcePathWithoutExtension(filename: string): string {\n  return filename.replace(/\\.(?:mdx|md)$/, \"\");\n}\n\nfunction docSourceSlugFromFilename(filename: string): string {\n  return docSourcePathWithoutExtension(\n    filename.split(/[\\\\/]/).pop() ?? filename,\n  );\n}\n\nfunction preferMdxDocSourceFiles(files: string[]): string[] {\n  const byPath = new Map<string, string>();\n  for (const file of [...files].sort()) {\n    if (!isDocSourceFile(file)) continue;\n\n    const pathWithoutExtension = docSourcePathWithoutExtension(file);\n    const existing = byPath.get(pathWithoutExtension);\n    if (!existing || file.endsWith(\".mdx\")) {\n      byPath.set(pathWithoutExtension, file);\n    }\n  }\n  return Array.from(byPath.values()).sort((a, b) =>\n    docSourcePathWithoutExtension(a).localeCompare(\n      docSourcePathWithoutExtension(b),\n    ),\n  );\n}\n\nfunction loadMarkdownDoc(filePath: string, slug: string): DocFull {\n  const raw = fs.readFileSync(filePath, \"utf-8\");\n  const { data, body } = parseFrontmatter(raw);\n  return {\n    slug,\n    title: data.title || data.name || titleFromBody(body) || slug,\n    description: data.description || \"\",\n    body,\n  };\n}\n\nfunction loadFilesystemDocs(): DocFull[] {\n  const docs: DocFull[] = [];\n  const rootDocs = [\n    { file: \"AGENTS.md\", slug: \"agent-native-docs\" },\n    { file: \"SKILL.md\", slug: \"agent-native-docs-skill\" },\n    { file: \"README.md\", slug: \"agent-native-docs-readme\" },\n  ];\n  for (const doc of rootDocs) {\n    const filePath = path.join(getDocsRoot(), doc.file);\n    if (fs.existsSync(filePath)) {\n      docs.push(loadMarkdownDoc(filePath, doc.slug));\n    }\n  }\n\n  const docsDir = getDocsDir();\n  if (!fs.existsSync(docsDir)) return docs;\n\n  const files = preferMdxDocSourceFiles(\n    fs\n      .readdirSync(docsDir)\n      .filter((file) => fs.statSync(path.join(docsDir, file)).isFile()),\n  );\n  docs.push(\n    ...files.map((file) => {\n      const slug = docSourceSlugFromFilename(file);\n      return loadMarkdownDoc(path.join(docsDir, file), slug);\n    }),\n  );\n  return docs;\n}\n\nfunction slugifyDocId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nasync function loadAgentBundleDocs(): Promise<DocFull[]> {\n  try {\n    const { loadAgentsBundle, getRuntimeSkills, skillSubfileDocsSlug } =\n      await import(\"../../server/agents-bundle.js\");\n    const bundle = await loadAgentsBundle();\n    const docs: DocFull[] = [];\n    if (bundle.workspaceAgentsMd?.trim()) {\n      docs.push({\n        slug: \"agents-workspace\",\n        title: \"Workspace AGENTS.md\",\n        description: \"Full bundled workspace-level agent instructions.\",\n        body: bundle.workspaceAgentsMd,\n      });\n    }\n    if (bundle.agentsMd?.trim()) {\n      docs.push({\n        slug: \"agents-template\",\n        title: \"Template AGENTS.md\",\n        description: \"Full bundled template/app agent instructions.\",\n        body: bundle.agentsMd,\n      });\n    }\n    // Only runtime-visible skills are searchable/readable here — `scope: dev`\n    // skills are meant for the human's coding agent (Claude Code), not the\n    // in-app runtime agent, so they must not appear in docs-search results.\n    for (const skill of getRuntimeSkills(bundle)) {\n      const slug = `skill-${slugifyDocId(skill.meta.name)}`;\n      docs.push({\n        slug,\n        title: `Skill: ${skill.meta.name}`,\n        description: skill.meta.description,\n        body: skill.content,\n      });\n      // Progressive-disclosure sub-files (e.g. `references/*.md`) get their\n      // own searchable/readable doc so the \"also contains\" pointers the\n      // skill prompt block advertises actually resolve to something.\n      for (const [relPath, content] of Object.entries(skill.files)) {\n        docs.push({\n          slug: skillSubfileDocsSlug(skill.meta.name, relPath),\n          title: `Skill: ${skill.meta.name} — ${relPath}`,\n          description: `Reference file from the \"${skill.meta.name}\" skill (${relPath}).`,\n          body: content,\n        });\n      }\n    }\n    return docs;\n  } catch {\n    return [];\n  }\n}\n\nasync function loadAllDocs(): Promise<DocFull[]> {\n  return [...loadFilesystemDocs(), ...(await loadAgentBundleDocs())];\n}\n\nasync function searchDocs(query: string): Promise<DocMeta[]> {\n  const docs = await loadAllDocs();\n  const terms = query.toLowerCase().split(/\\s+/);\n\n  const scored = docs\n    .map((doc) => {\n      const searchText =\n        `${doc.title} ${doc.description} ${doc.body}`.toLowerCase();\n      let score = 0;\n      for (const term of terms) {\n        if (doc.title.toLowerCase().includes(term)) score += 10;\n        if (doc.description.toLowerCase().includes(term)) score += 5;\n        if (doc.slug.includes(term)) score += 8;\n        // Count body occurrences\n        const bodyMatches = searchText.split(term).length - 1;\n        score += Math.min(bodyMatches, 5);\n      }\n      return { doc, score };\n    })\n    .filter((item) => item.score > 0)\n    .sort((a, b) => b.score - a.score);\n\n  return scored.map(({ doc }) => ({\n    slug: doc.slug,\n    title: doc.title,\n    description: doc.description,\n  }));\n}\n\nexport default async function docsSearchScript(args: string[]): Promise<void> {\n  const parsed = parseArgs(args);\n\n  if (parsed.help === \"true\") {\n    console.log(`Usage: pnpm action docs-search [options]\n\nOptions:\n  --query <text>    Search docs by keyword (returns matching pages)\n  --slug <slug>     Read a specific doc page by slug\n  --list            List all available doc pages\n  --help            Show this help message`);\n    return;\n  }\n\n  if (parsed.list === \"true\") {\n    const docs = await loadAllDocs();\n    const listing = docs.map((d) => ({\n      slug: d.slug,\n      title: d.title,\n      description: d.description,\n    }));\n    console.log(JSON.stringify(listing, null, 2));\n    return;\n  }\n\n  if (parsed.slug) {\n    const docs = await loadAllDocs();\n    const doc = docs.find((d) => d.slug === parsed.slug);\n    if (!doc) {\n      console.log(`Doc not found: ${parsed.slug}`);\n      console.log(`Available: ${docs.map((d) => d.slug).join(\", \")}`);\n      return;\n    }\n    console.log(`# ${doc.title}\\n`);\n    if (doc.description) console.log(`${doc.description}\\n`);\n    console.log(doc.body);\n    return;\n  }\n\n  if (parsed.query) {\n    const results = await searchDocs(parsed.query);\n    if (results.length === 0) {\n      console.log(`No docs found matching \"${parsed.query}\".`);\n      return;\n    }\n    console.log(`Found ${results.length} doc(s) matching \"${parsed.query}\":\\n`);\n    for (const result of results.slice(0, 8)) {\n      console.log(`  ${result.slug} — ${result.title}`);\n      if (result.description) {\n        console.log(`    ${result.description}`);\n      }\n    }\n    console.log(`\\nUse --slug <slug> to read the full doc.`);\n    return;\n  }\n\n  console.log(\"Provide --query, --slug, or --list. Use --help for details.\");\n}\n"]}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/scripts/docs/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAYxC,SAAS,WAAW;IAClB,iCAAiC;IACjC,wCAAwC;IACxC,yCAAyC;IACzC,OAAO,IAAI,CAAC,OAAO,CACjB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAC/C,eAAe,CAChB,CAAC;AACJ,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,2BAA2B;IAClC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAAE,OAAO;IACxC,OAAO,CAAC,GAAG,CACT,uEAAuE;QACrE,uEAAuE;QACvE,0EAA0E;QAC1E,oBAAoB,CACvB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IAInC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAE3C,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAChD,IAAI,CAAC;YAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC9C,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,6BAA6B,CAAC,QAAgB;IACrD,OAAO,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,yBAAyB,CAAC,QAAgB;IACjD,OAAO,6BAA6B,CAClC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAC1C,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAe;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;YAAE,SAAS;QAErC,MAAM,oBAAoB,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,6BAA6B,CAAC,CAAC,CAAC,CAAC,aAAa,CAC5C,6BAA6B,CAAC,CAAC,CAAC,CACjC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,IAAY;IACrD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI;QAC7D,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;QACnC,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG;QACf,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,EAAE;QAChD,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,yBAAyB,EAAE;QACrD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,0BAA0B,EAAE;KACxD,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,KAAK,GAAG,uBAAuB,CACnC,EAAE;SACC,WAAW,CAAC,OAAO,CAAC;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CACpE,CAAC;IACF,IAAI,CAAC,IAAI,CACP,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC,CACH,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,GAChE,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;QACxC,MAAM,IAAI,GAAc,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,qBAAqB;gBAC5B,WAAW,EAAE,kDAAkD;gBAC/D,IAAI,EAAE,MAAM,CAAC,iBAAiB;aAC/B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,iBAAiB;gBACvB,KAAK,EAAE,oBAAoB;gBAC3B,WAAW,EAAE,+CAA+C;gBAC5D,IAAI,EAAE,MAAM,CAAC,QAAQ;aACtB,CAAC,CAAC;QACL,CAAC;QACD,0EAA0E;QAC1E,uEAAuE;QACvE,wEAAwE;QACxE,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,SAAS,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI;gBACJ,KAAK,EAAE,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;gBAClC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;gBACnC,IAAI,EAAE,KAAK,CAAC,OAAO;aACpB,CAAC,CAAC;YACH,sEAAsE;YACtE,kEAAkE;YAClE,+DAA+D;YAC/D,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;oBACpD,KAAK,EAAE,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,OAAO,EAAE;oBAC/C,WAAW,EAAE,4BAA4B,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,OAAO,IAAI;oBAC/E,IAAI,EAAE,OAAO;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,OAAO,CAAC,GAAG,kBAAkB,EAAE,EAAE,GAAG,CAAC,MAAM,mBAAmB,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,IAAI;SAChB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,UAAU,GACd,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,IAAI,EAAE,CAAC;YACxD,IAAI,GAAG,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;YACxC,yBAAyB;YACzB,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YACtD,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC;;;;;;2CAM2B,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,MAAM,WAAW,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChE,2BAA2B,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,WAAW;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;YACzD,2BAA2B,EAAE,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,qBAAqB,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC;QAC5E,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;AAC7E,CAAC","sourcesContent":["/**\n * Core script: docs-search\n *\n * Search and read agent-native framework documentation.\n * Docs are bundled in @agent-native/core so they're always the right version.\n *\n * Usage:\n *   pnpm action docs-search --query \"actions\"\n *   pnpm action docs-search --slug authentication\n *   pnpm action docs-search --list\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport { parseArgs } from \"../utils.js\";\n\ninterface DocMeta {\n  slug: string;\n  title: string;\n  description: string;\n}\n\ninterface DocFull extends DocMeta {\n  body: string;\n}\n\nfunction getDocsRoot(): string {\n  // Resolve from the package root:\n  //   src/scripts/docs/search.ts -> docs/\n  //   dist/scripts/docs/search.js -> docs/\n  return path.resolve(\n    path.dirname(new URL(import.meta.url).pathname),\n    \"../../../docs\",\n  );\n}\n\nfunction getDocsDir(): string {\n  return path.join(getDocsRoot(), \"content\");\n}\n\n/**\n * Bundled serverless deploys carry the runtime agent bundle but not the\n * framework doc pages, so a miss there means \"not deployed\", not \"no such\n * doc\". Say which, or the agent concludes a documented API does not exist.\n */\nfunction logMissingFrameworkDocsNote(): void {\n  if (fs.existsSync(getDocsDir())) return;\n  console.log(\n    \"\\nNote: bundled framework doc pages are not deployed here (only this \" +\n      \"app's AGENTS.md and skills are). A miss above does not mean the page \" +\n      \"does not exist — check the framework docs another way before concluding \" +\n      \"an API is missing.\",\n  );\n}\n\nfunction parseFrontmatter(raw: string): {\n  data: Record<string, string>;\n  body: string;\n} {\n  const match = raw.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n([\\s\\S]*)$/);\n  if (!match) return { data: {}, body: raw };\n\n  const data: Record<string, string> = {};\n  for (const line of match[1].split(\"\\n\")) {\n    const m = line.match(/^(\\w+):\\s*\"?(.*?)\"?\\s*$/);\n    if (m) data[m[1]] = m[2];\n  }\n  return { data, body: match[2] };\n}\n\nfunction titleFromBody(body: string): string | null {\n  const heading = body.match(/^#\\s+(.+?)\\s*$/m);\n  return heading?.[1]?.trim() || null;\n}\n\nfunction isDocSourceFile(filename: string): boolean {\n  return filename.endsWith(\".mdx\") || filename.endsWith(\".md\");\n}\n\nfunction docSourcePathWithoutExtension(filename: string): string {\n  return filename.replace(/\\.(?:mdx|md)$/, \"\");\n}\n\nfunction docSourceSlugFromFilename(filename: string): string {\n  return docSourcePathWithoutExtension(\n    filename.split(/[\\\\/]/).pop() ?? filename,\n  );\n}\n\nfunction preferMdxDocSourceFiles(files: string[]): string[] {\n  const byPath = new Map<string, string>();\n  for (const file of [...files].sort()) {\n    if (!isDocSourceFile(file)) continue;\n\n    const pathWithoutExtension = docSourcePathWithoutExtension(file);\n    const existing = byPath.get(pathWithoutExtension);\n    if (!existing || file.endsWith(\".mdx\")) {\n      byPath.set(pathWithoutExtension, file);\n    }\n  }\n  return Array.from(byPath.values()).sort((a, b) =>\n    docSourcePathWithoutExtension(a).localeCompare(\n      docSourcePathWithoutExtension(b),\n    ),\n  );\n}\n\nfunction loadMarkdownDoc(filePath: string, slug: string): DocFull {\n  const raw = fs.readFileSync(filePath, \"utf-8\");\n  const { data, body } = parseFrontmatter(raw);\n  return {\n    slug,\n    title: data.title || data.name || titleFromBody(body) || slug,\n    description: data.description || \"\",\n    body,\n  };\n}\n\nfunction loadFilesystemDocs(): DocFull[] {\n  const docs: DocFull[] = [];\n  const rootDocs = [\n    { file: \"AGENTS.md\", slug: \"agent-native-docs\" },\n    { file: \"SKILL.md\", slug: \"agent-native-docs-skill\" },\n    { file: \"README.md\", slug: \"agent-native-docs-readme\" },\n  ];\n  for (const doc of rootDocs) {\n    const filePath = path.join(getDocsRoot(), doc.file);\n    if (fs.existsSync(filePath)) {\n      docs.push(loadMarkdownDoc(filePath, doc.slug));\n    }\n  }\n\n  const docsDir = getDocsDir();\n  if (!fs.existsSync(docsDir)) return docs;\n\n  const files = preferMdxDocSourceFiles(\n    fs\n      .readdirSync(docsDir)\n      .filter((file) => fs.statSync(path.join(docsDir, file)).isFile()),\n  );\n  docs.push(\n    ...files.map((file) => {\n      const slug = docSourceSlugFromFilename(file);\n      return loadMarkdownDoc(path.join(docsDir, file), slug);\n    }),\n  );\n  return docs;\n}\n\nfunction slugifyDocId(value: string): string {\n  return value\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nasync function loadAgentBundleDocs(): Promise<DocFull[]> {\n  try {\n    const { loadAgentsBundle, getRuntimeSkills, skillSubfileDocsSlug } =\n      await import(\"../../server/agents-bundle.js\");\n    const bundle = await loadAgentsBundle();\n    const docs: DocFull[] = [];\n    if (bundle.workspaceAgentsMd?.trim()) {\n      docs.push({\n        slug: \"agents-workspace\",\n        title: \"Workspace AGENTS.md\",\n        description: \"Full bundled workspace-level agent instructions.\",\n        body: bundle.workspaceAgentsMd,\n      });\n    }\n    if (bundle.agentsMd?.trim()) {\n      docs.push({\n        slug: \"agents-template\",\n        title: \"Template AGENTS.md\",\n        description: \"Full bundled template/app agent instructions.\",\n        body: bundle.agentsMd,\n      });\n    }\n    // Only runtime-visible skills are searchable/readable here — `scope: dev`\n    // skills are meant for the human's coding agent (Claude Code), not the\n    // in-app runtime agent, so they must not appear in docs-search results.\n    for (const skill of getRuntimeSkills(bundle)) {\n      const slug = `skill-${slugifyDocId(skill.meta.name)}`;\n      docs.push({\n        slug,\n        title: `Skill: ${skill.meta.name}`,\n        description: skill.meta.description,\n        body: skill.content,\n      });\n      // Progressive-disclosure sub-files (e.g. `references/*.md`) get their\n      // own searchable/readable doc so the \"also contains\" pointers the\n      // skill prompt block advertises actually resolve to something.\n      for (const [relPath, content] of Object.entries(skill.files)) {\n        docs.push({\n          slug: skillSubfileDocsSlug(skill.meta.name, relPath),\n          title: `Skill: ${skill.meta.name} — ${relPath}`,\n          description: `Reference file from the \"${skill.meta.name}\" skill (${relPath}).`,\n          body: content,\n        });\n      }\n    }\n    return docs;\n  } catch {\n    return [];\n  }\n}\n\nasync function loadAllDocs(): Promise<DocFull[]> {\n  return [...loadFilesystemDocs(), ...(await loadAgentBundleDocs())];\n}\n\nasync function searchDocs(query: string): Promise<DocMeta[]> {\n  const docs = await loadAllDocs();\n  const terms = query.toLowerCase().split(/\\s+/);\n\n  const scored = docs\n    .map((doc) => {\n      const searchText =\n        `${doc.title} ${doc.description} ${doc.body}`.toLowerCase();\n      let score = 0;\n      for (const term of terms) {\n        if (doc.title.toLowerCase().includes(term)) score += 10;\n        if (doc.description.toLowerCase().includes(term)) score += 5;\n        if (doc.slug.includes(term)) score += 8;\n        // Count body occurrences\n        const bodyMatches = searchText.split(term).length - 1;\n        score += Math.min(bodyMatches, 5);\n      }\n      return { doc, score };\n    })\n    .filter((item) => item.score > 0)\n    .sort((a, b) => b.score - a.score);\n\n  return scored.map(({ doc }) => ({\n    slug: doc.slug,\n    title: doc.title,\n    description: doc.description,\n  }));\n}\n\nexport default async function docsSearchScript(args: string[]): Promise<void> {\n  const parsed = parseArgs(args);\n\n  if (parsed.help === \"true\") {\n    console.log(`Usage: pnpm action docs-search [options]\n\nOptions:\n  --query <text>    Search docs by keyword (returns matching pages)\n  --slug <slug>     Read a specific doc page by slug\n  --list            List all available doc pages\n  --help            Show this help message`);\n    return;\n  }\n\n  if (parsed.list === \"true\") {\n    const docs = await loadAllDocs();\n    const listing = docs.map((d) => ({\n      slug: d.slug,\n      title: d.title,\n      description: d.description,\n    }));\n    console.log(JSON.stringify(listing, null, 2));\n    return;\n  }\n\n  if (parsed.slug) {\n    const docs = await loadAllDocs();\n    const doc = docs.find((d) => d.slug === parsed.slug);\n    if (!doc) {\n      console.log(`Doc not found: ${parsed.slug}`);\n      console.log(`Available: ${docs.map((d) => d.slug).join(\", \")}`);\n      logMissingFrameworkDocsNote();\n      return;\n    }\n    console.log(`# ${doc.title}\\n`);\n    if (doc.description) console.log(`${doc.description}\\n`);\n    console.log(doc.body);\n    return;\n  }\n\n  if (parsed.query) {\n    const results = await searchDocs(parsed.query);\n    if (results.length === 0) {\n      console.log(`No docs found matching \"${parsed.query}\".`);\n      logMissingFrameworkDocsNote();\n      return;\n    }\n    console.log(`Found ${results.length} doc(s) matching \"${parsed.query}\":\\n`);\n    for (const result of results.slice(0, 8)) {\n      console.log(`  ${result.slug} — ${result.title}`);\n      if (result.description) {\n        console.log(`    ${result.description}`);\n      }\n    }\n    console.log(`\\nUse --slug <slug> to read the full doc.`);\n    return;\n  }\n\n  console.log(\"Provide --query, --slug, or --list. Use --help for details.\");\n}\n"]}

package/dist/scripts/docs/source-search.d.ts

@@ -10,5 +10,12 @@
  *   pnpm action source-search --path templates/plan/AGENTS.md
  *   pnpm action source-search --list
  */
+/**
+ * The corpus is a sibling of the package root, so a bundled serverless deploy
+ * never carries it. Callers register this tool conditionally: advertising a
+ * search tool whose only possible answer is "not found" costs the agent a turn
+ * and reads to it like the code genuinely does not exist.
+ */
+export declare function hasSourceCorpus(): boolean;
 export default function sourceSearchScript(args: string[]): Promise<void>;
 //# sourceMappingURL=source-search.d.ts.map

package/dist/scripts/docs/source-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-search.d.ts","sourceRoot":"","sources":["../../../src/scripts/docs/source-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAwSH,wBAA8B,kBAAkB,CAC9C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAqDf"}
+{"version":3,"file":"source-search.d.ts","sourceRoot":"","sources":["../../../src/scripts/docs/source-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6DH;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AA6OD,wBAA8B,kBAAkB,CAC9C,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/dist/scripts/docs/source-search.js

@@ -57,6 +57,15 @@ function getCorpusRoot() {
     //   dist/scripts/docs/source-search.js -> corpus/
     return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../corpus");
 }
+/**
+ * The corpus is a sibling of the package root, so a bundled serverless deploy
+ * never carries it. Callers register this tool conditionally: advertising a
+ * search tool whose only possible answer is "not found" costs the agent a turn
+ * and reads to it like the code genuinely does not exist.
+ */
+export function hasSourceCorpus() {
+    return fs.existsSync(getCorpusRoot());
+}
 function isProbablyTextFile(filePath) {
     const ext = path.extname(filePath).toLowerCase();
     if (TEXT_EXTENSIONS.has(ext))