@raybase/create 0.0.2 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/THIRD_PARTY_NOTICES.md +38 -0
- package/assets/apple-touch-icons/0.png +0 -0
- package/assets/apple-touch-icons/1.png +0 -0
- package/assets/apple-touch-icons/2.png +0 -0
- package/assets/apple-touch-icons/3.png +0 -0
- package/assets/apple-touch-icons/4.png +0 -0
- package/assets/apple-touch-icons/5.png +0 -0
- package/assets/apple-touch-icons/6.png +0 -0
- package/assets/apple-touch-icons/7.png +0 -0
- package/assets/apple-touch-icons/8.png +0 -0
- package/assets/apple-touch-icons/9.png +0 -0
- package/assets/apple-touch-icons/A.png +0 -0
- package/assets/apple-touch-icons/B.png +0 -0
- package/assets/apple-touch-icons/C.png +0 -0
- package/assets/apple-touch-icons/D.png +0 -0
- package/assets/apple-touch-icons/E.png +0 -0
- package/assets/apple-touch-icons/F.png +0 -0
- package/assets/apple-touch-icons/G.png +0 -0
- package/assets/apple-touch-icons/H.png +0 -0
- package/assets/apple-touch-icons/I.png +0 -0
- package/assets/apple-touch-icons/J.png +0 -0
- package/assets/apple-touch-icons/K.png +0 -0
- package/assets/apple-touch-icons/L.png +0 -0
- package/assets/apple-touch-icons/M.png +0 -0
- package/assets/apple-touch-icons/N.png +0 -0
- package/assets/apple-touch-icons/O.png +0 -0
- package/assets/apple-touch-icons/P.png +0 -0
- package/assets/apple-touch-icons/Q.png +0 -0
- package/assets/apple-touch-icons/R.png +0 -0
- package/assets/apple-touch-icons/S.png +0 -0
- package/assets/apple-touch-icons/T.png +0 -0
- package/assets/apple-touch-icons/U.png +0 -0
- package/assets/apple-touch-icons/V.png +0 -0
- package/assets/apple-touch-icons/W.png +0 -0
- package/assets/apple-touch-icons/X.png +0 -0
- package/assets/apple-touch-icons/Y.png +0 -0
- package/assets/apple-touch-icons/Z.png +0 -0
- package/assets/apple-touch-icons/default.png +0 -0
- package/dist/.source-hash +1 -0
- package/dist/index.d.ts +56 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2351 -0
- package/dist/index.js.map +1 -0
- package/dist/raybase-package-ranges.d.ts +11 -0
- package/dist/raybase-package-ranges.d.ts.map +1 -0
- package/dist/raybase-package-ranges.js +11 -0
- package/dist/raybase-package-ranges.js.map +1 -0
- package/dist/source-fetch.d.ts +91 -0
- package/dist/source-fetch.d.ts.map +1 -0
- package/dist/source-fetch.js +325 -0
- package/dist/source-fetch.js.map +1 -0
- package/dist/source-hash.d.ts +2 -0
- package/dist/source-hash.d.ts.map +1 -0
- package/dist/source-hash.js +23 -0
- package/dist/source-hash.js.map +1 -0
- package/dist/starter-description.d.ts +44 -0
- package/dist/starter-description.d.ts.map +1 -0
- package/dist/starter-description.js +273 -0
- package/dist/starter-description.js.map +1 -0
- package/dist/starter-source.d.ts +43 -0
- package/dist/starter-source.d.ts.map +1 -0
- package/dist/starter-source.js +156 -0
- package/dist/starter-source.js.map +1 -0
- package/dist/store-app-apply.d.ts +27 -0
- package/dist/store-app-apply.d.ts.map +1 -0
- package/dist/store-app-apply.js +100 -0
- package/dist/store-app-apply.js.map +1 -0
- package/dist/store-app-manifest.d.ts +86 -0
- package/dist/store-app-manifest.d.ts.map +1 -0
- package/dist/store-app-manifest.js +110 -0
- package/dist/store-app-manifest.js.map +1 -0
- package/dist/store-app-registry.d.ts +30 -0
- package/dist/store-app-registry.d.ts.map +1 -0
- package/dist/store-app-registry.js +232 -0
- package/dist/store-app-registry.js.map +1 -0
- package/models/recommended.json +42 -0
- package/modules/api/templates/react-router/app/api/operations.ts +8 -0
- package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
- package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
- package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
- package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
- package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
- package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
- package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
- package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
- package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
- package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
- package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
- package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
- package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
- package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
- package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
- package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
- package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
- package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
- package/modules/docs/templates/react-router/source.config.ts +5 -0
- package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
- package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
- package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
- package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
- package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
- package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
- package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
- package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
- package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
- package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
- package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
- package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
- package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
- package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
- package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
- package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
- package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
- package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
- package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
- package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
- package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
- package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
- package/package.json +34 -8
- package/skills/README.md +122 -0
- package/skills/raybase-actions/SKILL.md +223 -0
- package/skills/raybase-actions/references/action-patterns.md +190 -0
- package/skills/raybase-actions/references/adapting-actions.md +93 -0
- package/skills/raybase-actions/references/testing-actions.md +48 -0
- package/skills/raybase-agent-debugging/SKILL.md +230 -0
- package/skills/raybase-ai/SKILL.md +1310 -0
- package/skills/raybase-api/SKILL.md +45 -0
- package/skills/raybase-astro-emdash/SKILL.md +143 -0
- package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
- package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
- package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
- package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
- package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
- package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
- package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
- package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
- package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
- package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
- package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
- package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
- package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
- package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
- package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
- package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
- package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
- package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
- package/skills/raybase-auth/SKILL.md +358 -0
- package/skills/raybase-background-jobs/SKILL.md +774 -0
- package/skills/raybase-building/SKILL.md +409 -0
- package/skills/raybase-building/references/interview-and-spec.md +87 -0
- package/skills/raybase-building/references/planning-docs.md +26 -0
- package/skills/raybase-building/references/schema-and-config.md +70 -0
- package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
- package/skills/raybase-data-and-policies/SKILL.md +377 -0
- package/skills/raybase-deploy/SKILL.md +136 -0
- package/skills/raybase-docs-writing/SKILL.md +119 -0
- package/skills/raybase-guide/SKILL.md +235 -0
- package/skills/raybase-mcp/SKILL.md +309 -0
- package/skills/raybase-mcp/agents/openai.yaml +4 -0
- package/skills/raybase-notifications/SKILL.md +138 -0
- package/skills/raybase-pro-migration/SKILL.md +28 -0
- package/skills/raybase-react-router/SKILL.md +241 -0
- package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
- package/skills/raybase-react-router-design/SKILL.md +135 -0
- package/skills/raybase-react-router-design/reference/color.md +87 -0
- package/skills/raybase-react-router-design/reference/copy.md +83 -0
- package/skills/raybase-react-router-design/reference/delight.md +48 -0
- package/skills/raybase-react-router-design/reference/interaction.md +91 -0
- package/skills/raybase-react-router-design/reference/layout.md +82 -0
- package/skills/raybase-react-router-design/reference/motion.md +86 -0
- package/skills/raybase-react-router-design/reference/polish.md +79 -0
- package/skills/raybase-react-router-design/reference/typography.md +71 -0
- package/skills/raybase-react-router-security-review/LICENSE +22 -0
- package/skills/raybase-react-router-security-review/SKILL.md +190 -0
- package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
- package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
- package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
- package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
- package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
- package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
- package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
- package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
- package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
- package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
- package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
- package/skills/raybase-react-router-security-review/references/injection.md +259 -0
- package/skills/raybase-react-router-security-review/references/logging.md +433 -0
- package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
- package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
- package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
- package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
- package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
- package/skills/raybase-react-router-security-review/references/xss.md +336 -0
- package/skills/raybase-realtime/SKILL.md +158 -0
- package/skills/raybase-realtime/agents/openai.yaml +4 -0
- package/skills/raybase-schema/SKILL.md +209 -0
- package/skills/raybase-search/SKILL.md +137 -0
- package/skills/raybase-search/agents/openai.yaml +4 -0
- package/skills/raybase-settings/SKILL.md +139 -0
- package/skills/raybase-settings/agents/openai.yaml +4 -0
- package/skills/raybase-tanstack-start/SKILL.md +166 -0
- package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
- package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
- package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
- package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
- package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
- package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
- package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
- package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
- package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
- package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
- package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
- package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
- package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
- package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
- package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
- package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
- package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
- package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
- package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
- package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
- package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
- package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
- package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
- package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
- package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
- package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
- package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
- package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
- package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
- package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
- package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
- package/skills-manifest.json +41 -0
- package/templates/astro-emdash/.dev.vars.example +7 -0
- package/templates/astro-emdash/AGENTS.md +122 -0
- package/templates/astro-emdash/DESIGN.md +90 -0
- package/templates/astro-emdash/components.json +21 -0
- package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
- package/templates/astro-emdash/content/docs/index.mdx +13 -0
- package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
- package/templates/astro-emdash/content/docs/meta.json +4 -0
- package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
- package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
- package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
- package/templates/astro-emdash/dev/SPEC.md +84 -0
- package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
- package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
- package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
- package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
- package/templates/astro-emdash/docs/themes.md +106 -0
- package/templates/astro-emdash/drizzle.config.ts +5 -0
- package/templates/astro-emdash/gitignore +11 -0
- package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
- package/templates/astro-emdash/package.json +79 -0
- package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
- package/templates/astro-emdash/public/_headers +4 -0
- package/templates/astro-emdash/site/astro.config.mjs +120 -0
- package/templates/astro-emdash/site/demo/README.md +72 -0
- package/templates/astro-emdash/site/demo/content/collection.json +43 -0
- package/templates/astro-emdash/site/demo/content/entries.json +120 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
- package/templates/astro-emdash/site/gitignore +1 -0
- package/templates/astro-emdash/site/package.json +56 -0
- package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
- package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
- package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
- package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
- package/templates/astro-emdash/site/seed/seed.json +154 -0
- package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
- package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
- package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
- package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
- package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
- package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
- package/templates/astro-emdash/site/src/env.d.ts +12 -0
- package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
- package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
- package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
- package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
- package/templates/astro-emdash/site/src/live.config.ts +8 -0
- package/templates/astro-emdash/site/src/middleware.ts +20 -0
- package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
- package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
- package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
- package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
- package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
- package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
- package/templates/astro-emdash/site/src/styles.css +607 -0
- package/templates/astro-emdash/site/tsconfig.json +12 -0
- package/templates/astro-emdash/site/wrangler.jsonc +34 -0
- package/templates/astro-emdash/source.config.ts +10 -0
- package/templates/astro-emdash/src/actions.ts +58 -0
- package/templates/astro-emdash/src/ai/agents.ts +20 -0
- package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
- package/templates/astro-emdash/src/auth-door.ts +18 -0
- package/templates/astro-emdash/src/client.tsx +25 -0
- package/templates/astro-emdash/src/components/.gitkeep +1 -0
- package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
- package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
- package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
- package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
- package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
- package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
- package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
- package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
- package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
- package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
- package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
- package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
- package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
- package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
- package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
- package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
- package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
- package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
- package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
- package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
- package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
- package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
- package/templates/astro-emdash/src/db/schema.ts +6 -0
- package/templates/astro-emdash/src/db/seed.ts +16 -0
- package/templates/astro-emdash/src/db/storage.ts +32 -0
- package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
- package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
- package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
- package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
- package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
- package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
- package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
- package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
- package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
- package/templates/astro-emdash/src/docs/source.ts +7 -0
- package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
- package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
- package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
- package/templates/astro-emdash/src/jobs.example.ts +48 -0
- package/templates/astro-emdash/src/lib/account.ts +12 -0
- package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
- package/templates/astro-emdash/src/lib/utils.ts +6 -0
- package/templates/astro-emdash/src/mcp-app.ts +57 -0
- package/templates/astro-emdash/src/notifications.example.ts +37 -0
- package/templates/astro-emdash/src/raybase.auth.ts +70 -0
- package/templates/astro-emdash/src/raybase.config.ts +49 -0
- package/templates/astro-emdash/src/raybase.server.ts +56 -0
- package/templates/astro-emdash/src/realtime.example.ts +18 -0
- package/templates/astro-emdash/src/router.tsx +19 -0
- package/templates/astro-emdash/src/routes/__root.tsx +56 -0
- package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
- package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
- package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
- package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
- package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
- package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
- package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
- package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
- package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
- package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
- package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
- package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
- package/templates/astro-emdash/src/routes/_app.tsx +33 -0
- package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
- package/templates/astro-emdash/src/routes/api/$.ts +19 -0
- package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
- package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
- package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
- package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
- package/templates/astro-emdash/src/routes/docs.tsx +22 -0
- package/templates/astro-emdash/src/search.ts +6 -0
- package/templates/astro-emdash/src/settings.ts +12 -0
- package/templates/astro-emdash/src/styles-docs.css +3 -0
- package/templates/astro-emdash/src/styles.css +101 -0
- package/templates/astro-emdash/src/themes/base.css +76 -0
- package/templates/astro-emdash/src/themes/carbon.css +76 -0
- package/templates/astro-emdash/src/themes/fonts.css +25 -0
- package/templates/astro-emdash/src/themes/sage.css +76 -0
- package/templates/astro-emdash/src/themes/sand.css +76 -0
- package/templates/astro-emdash/src/themes/slate.css +81 -0
- package/templates/astro-emdash/src/themes/ultra.css +76 -0
- package/templates/astro-emdash/src/themes/zen.css +76 -0
- package/templates/astro-emdash/src/worker-entry.ts +31 -0
- package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
- package/templates/astro-emdash/tsconfig.json +36 -0
- package/templates/astro-emdash/vite.config.ts +130 -0
- package/templates/astro-emdash/vitest.config.ts +8 -0
- package/templates/astro-emdash/wrangler.jsonc +112 -0
- package/templates/react-router/.dev.vars.example +5 -0
- package/templates/react-router/.editorconfig +15 -0
- package/templates/react-router/AGENTS.md +54 -0
- package/templates/react-router/README.md +52 -0
- package/templates/react-router/app/app.css +44 -0
- package/templates/react-router/app/components/mdx.tsx +79 -0
- package/templates/react-router/app/components/ui/button.tsx +45 -0
- package/templates/react-router/app/components/ui/card.tsx +87 -0
- package/templates/react-router/app/components/ui/separator.tsx +22 -0
- package/templates/react-router/app/db/migrations.gen.ts +6 -0
- package/templates/react-router/app/db/schema.ts +56 -0
- package/templates/react-router/app/db/seed.ts +14 -0
- package/templates/react-router/app/entry.server.tsx +41 -0
- package/templates/react-router/app/globals.d.ts +1 -0
- package/templates/react-router/app/lib/layout.shared.tsx +52 -0
- package/templates/react-router/app/lib/source.ts +7 -0
- package/templates/react-router/app/lib/utils.ts +6 -0
- package/templates/react-router/app/raybase.server.ts +65 -0
- package/templates/react-router/app/root.tsx +23 -0
- package/templates/react-router/app/routes/_index.tsx +53 -0
- package/templates/react-router/app/routes/docs.$.tsx +49 -0
- package/templates/react-router/app/routes/docs.api.search.ts +10 -0
- package/templates/react-router/app/routes/docs.tsx +13 -0
- package/templates/react-router/app/routes.ts +3 -0
- package/templates/react-router/components.json +22 -0
- package/templates/react-router/content/docs/getting-started.mdx +15 -0
- package/templates/react-router/content/docs/index.mdx +8 -0
- package/templates/react-router/content/docs/mcp.mdx +121 -0
- package/templates/react-router/content/docs/meta.json +4 -0
- package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
- package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
- package/templates/react-router/dev/SPEC.md +93 -0
- package/templates/react-router/dev/features/archive/.gitkeep +1 -0
- package/templates/react-router/drizzle.config.ts +5 -0
- package/templates/react-router/env.d.ts +53 -0
- package/templates/react-router/gitignore +23 -0
- package/templates/react-router/migrations/app/meta/_journal.json +1 -0
- package/templates/react-router/package.json +70 -0
- package/templates/react-router/public/_headers +4 -0
- package/templates/react-router/public/favicon.ico +0 -0
- package/templates/react-router/react-router.config.ts +9 -0
- package/templates/react-router/source.config.ts +5 -0
- package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
- package/templates/react-router/tsconfig.json +27 -0
- package/templates/react-router/vite.config.ts +59 -0
- package/templates/react-router/vitest.config.ts +8 -0
- package/templates/react-router/workers/app.ts +40 -0
- package/templates/react-router/wrangler.jsonc +111 -0
- package/templates/tanstack-start/.dev.vars.example +5 -0
- package/templates/tanstack-start/AGENTS.md +95 -0
- package/templates/tanstack-start/DESIGN.md +65 -0
- package/templates/tanstack-start/components.json +21 -0
- package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
- package/templates/tanstack-start/content/docs/index.mdx +10 -0
- package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
- package/templates/tanstack-start/content/docs/meta.json +4 -0
- package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
- package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
- package/templates/tanstack-start/dev/SPEC.md +213 -0
- package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
- package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
- package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
- package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
- package/templates/tanstack-start/docs/themes.md +116 -0
- package/templates/tanstack-start/drizzle.config.ts +5 -0
- package/templates/tanstack-start/gitignore +11 -0
- package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
- package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
- package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
- package/templates/tanstack-start/package.json +77 -0
- package/templates/tanstack-start/public/_headers +8 -0
- package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
- package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
- package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
- package/templates/tanstack-start/public/manifest.webmanifest +14 -0
- package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
- package/templates/tanstack-start/source.config.ts +10 -0
- package/templates/tanstack-start/src/actions.ts +560 -0
- package/templates/tanstack-start/src/ai/agents.ts +78 -0
- package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
- package/templates/tanstack-start/src/auth-door.ts +18 -0
- package/templates/tanstack-start/src/client.tsx +25 -0
- package/templates/tanstack-start/src/components/.gitkeep +1 -0
- package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
- package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
- package/templates/tanstack-start/src/components/install-app.tsx +35 -0
- package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
- package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
- package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
- package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
- package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
- package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
- package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
- package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
- package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
- package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
- package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
- package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
- package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
- package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
- package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
- package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
- package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
- package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
- package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
- package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
- package/templates/tanstack-start/src/db/schema.ts +90 -0
- package/templates/tanstack-start/src/db/seed.ts +106 -0
- package/templates/tanstack-start/src/db/storage.ts +32 -0
- package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
- package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
- package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
- package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
- package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
- package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
- package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
- package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
- package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
- package/templates/tanstack-start/src/docs/source.ts +7 -0
- package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
- package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
- package/templates/tanstack-start/src/jobs.example.ts +56 -0
- package/templates/tanstack-start/src/lib/account.ts +13 -0
- package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
- package/templates/tanstack-start/src/lib/push-client.ts +98 -0
- package/templates/tanstack-start/src/lib/utils.ts +6 -0
- package/templates/tanstack-start/src/mcp-app.ts +74 -0
- package/templates/tanstack-start/src/notifications.example.ts +37 -0
- package/templates/tanstack-start/src/raybase.auth.ts +86 -0
- package/templates/tanstack-start/src/raybase.config.ts +86 -0
- package/templates/tanstack-start/src/raybase.server.ts +155 -0
- package/templates/tanstack-start/src/realtime.example.ts +46 -0
- package/templates/tanstack-start/src/router.tsx +19 -0
- package/templates/tanstack-start/src/routes/__root.tsx +73 -0
- package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
- package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
- package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
- package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
- package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
- package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
- package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
- package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
- package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
- package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
- package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
- package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
- package/templates/tanstack-start/src/routes/_app.tsx +33 -0
- package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
- package/templates/tanstack-start/src/routes/api/$.ts +19 -0
- package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
- package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
- package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
- package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
- package/templates/tanstack-start/src/routes/docs.tsx +22 -0
- package/templates/tanstack-start/src/search.ts +26 -0
- package/templates/tanstack-start/src/settings.ts +12 -0
- package/templates/tanstack-start/src/styles-docs.css +3 -0
- package/templates/tanstack-start/src/styles.css +73 -0
- package/templates/tanstack-start/src/themes/base.css +76 -0
- package/templates/tanstack-start/src/themes/carbon.css +76 -0
- package/templates/tanstack-start/src/themes/fonts.css +18 -0
- package/templates/tanstack-start/src/themes/sage.css +76 -0
- package/templates/tanstack-start/src/themes/sand.css +76 -0
- package/templates/tanstack-start/src/themes/slate.css +76 -0
- package/templates/tanstack-start/src/themes/ultra.css +76 -0
- package/templates/tanstack-start/src/themes/zen.css +76 -0
- package/templates/tanstack-start/src/worker-entry.ts +30 -0
- package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
- package/templates/tanstack-start/tsconfig.json +33 -0
- package/templates/tanstack-start/vite.config.ts +132 -0
- package/templates/tanstack-start/vitest.config.ts +8 -0
- package/templates/tanstack-start/wrangler.jsonc +112 -0
- package/README.md +0 -3
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { useRouter } from "@tanstack/react-router";
|
|
2
|
+
import { RaybaseAgentWidget } from "@raybase/agent-ui";
|
|
3
|
+
import { useEffect } from "react";
|
|
4
|
+
import { guideConfig } from "../guide/config";
|
|
5
|
+
|
|
6
|
+
export function GuideWidget() {
|
|
7
|
+
const router = useRouter();
|
|
8
|
+
|
|
9
|
+
useEffect(() => {
|
|
10
|
+
const refreshData = () => {
|
|
11
|
+
void router.invalidate();
|
|
12
|
+
};
|
|
13
|
+
window.addEventListener("raybase:data-changed", refreshData);
|
|
14
|
+
return () => window.removeEventListener("raybase:data-changed", refreshData);
|
|
15
|
+
}, [router]);
|
|
16
|
+
|
|
17
|
+
return (
|
|
18
|
+
<RaybaseAgentWidget
|
|
19
|
+
agentName={guideConfig.agent?.name ?? "guide"}
|
|
20
|
+
enabled={guideConfig.enabled ?? true}
|
|
21
|
+
isSurfaceEnabled={isGuideSurfaceEnabled}
|
|
22
|
+
resolveSurface={resolveGuideSurface}
|
|
23
|
+
title={guideConfig.agent?.title ?? "Guide"}
|
|
24
|
+
/>
|
|
25
|
+
);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
type GuideSurface = "app" | "docs";
|
|
29
|
+
|
|
30
|
+
function resolveGuideSurface(route: string): GuideSurface {
|
|
31
|
+
return route.startsWith("/docs") ? "docs" : "app";
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function isGuideSurfaceEnabled(surface: string): boolean {
|
|
35
|
+
if (!isGuideSurface(surface)) return false;
|
|
36
|
+
return guideConfig.surfaces?.[surface]?.enabled ?? surface === "app";
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function isGuideSurface(surface: string): surface is GuideSurface {
|
|
40
|
+
return surface === "app" || surface === "docs";
|
|
41
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { RaybaseAction } from "@raybase/core/actions";
|
|
2
|
+
import type { RaybaseEnv } from "@raybase/core/worker";
|
|
3
|
+
import { actions } from "../actions";
|
|
4
|
+
|
|
5
|
+
// Keep Guide on a narrow allow-list of app-declared actions.
|
|
6
|
+
export const guideActions = [
|
|
7
|
+
actions.contentSiteSnapshot
|
|
8
|
+
] satisfies Array<RaybaseAction<any, any, RaybaseEnv>>;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { GuideConfig } from "@raybase/guide";
|
|
2
|
+
|
|
3
|
+
export const guideConfig = {
|
|
4
|
+
enabled: true,
|
|
5
|
+
surfaces: {
|
|
6
|
+
app: { enabled: true, audience: "signed-in" },
|
|
7
|
+
docs: { enabled: true, audience: "signed-in" }
|
|
8
|
+
},
|
|
9
|
+
agent: {
|
|
10
|
+
name: "guide",
|
|
11
|
+
title: "Guide"
|
|
12
|
+
},
|
|
13
|
+
limits: {
|
|
14
|
+
publicIpHourlyRequests: 20,
|
|
15
|
+
publicIpHourlyOutputTokens: 12000,
|
|
16
|
+
publicDailyRequests: 200,
|
|
17
|
+
publicDailyOutputTokens: 60000,
|
|
18
|
+
signedInDailyRequests: 50,
|
|
19
|
+
maxCorpusSnippets: 8
|
|
20
|
+
}
|
|
21
|
+
} satisfies GuideConfig;
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"generatedAt": "2026-11-14T04:05:39.782Z",
|
|
4
|
+
"sources": [
|
|
5
|
+
{
|
|
6
|
+
"kind": "docs",
|
|
7
|
+
"path": "content/docs"
|
|
8
|
+
}
|
|
9
|
+
],
|
|
10
|
+
"documents": [
|
|
11
|
+
{
|
|
12
|
+
"id": "docs:content/docs:getting-started.mdx",
|
|
13
|
+
"title": "Opening the CMS",
|
|
14
|
+
"source": "docs",
|
|
15
|
+
"text": "Sign in with the account your team gave you, then open the public site and choose CMS from the signed in menu. Start with Pages. Open an existing draft to review the editing pattern, or create a page when you need a new public URL. Use the page content field to arrange reusable sections. Each section owns its own copy, media, links, and display options. Preview before publishing. If a page needs a new reusable section or a layout change, note the goal clearly and ask the project maintainer to add the building block. Local time travel In local development, use the fixed dev chrome or POST /api/dev/time with \"now\":\"2030 08 12T09:00:00.000Z\" to move the application clock. GET /api/dev/time reports virtual and real time; \"reset\":true returns to wall time. Forward jumps start bounded catch up for Jobs, Agent schedules, wakes, and follow ups. Repeating schedules coalesce to one run, while one shot work drains without waiting for the HTTP response. Auth, leases, retries, tokens, provider calls, and diagnostics remain on real time. Moving backward or resetting does not rewrite future dated rows; reset and reseed when a QA scenario crosses that edge. Local tooling can restore the spine's base world with POST /api/dev/seed and \"reset\":true or apply one named variant with \"variant\":\"empty spine\" . Reset is destructive for spine app tables; use sequential calls to layer variants, and use restore after time travel leaves future dated rows. Content site demo data remains owned by site/ . GET /api/dev/manifest serves the same validated manifestVersion: 1 checkpoint written to .raybase/app.manifest.json at dev startup. Route sources use project relative POSIX paths. Restart raybase dev after changing routes or declarations. The endpoint is local only.",
|
|
16
|
+
"url": "/docs/getting-started",
|
|
17
|
+
"routePatterns": [
|
|
18
|
+
"/docs/getting-started",
|
|
19
|
+
"/docs/getting-started/*"
|
|
20
|
+
],
|
|
21
|
+
"public": false,
|
|
22
|
+
"guideContext": null,
|
|
23
|
+
"updatedAt": "2026-11-14T04:05:26.116Z",
|
|
24
|
+
"hash": "sha256:6aec1b2e381585c532b62df227dd807aef7dbf91fe71d1f804a05e7793ce36ae"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"id": "docs:content/docs:index.mdx",
|
|
28
|
+
"title": "Editing the site",
|
|
29
|
+
"source": "docs",
|
|
30
|
+
"text": "The CMS is where signed in editors manage public site pages, drafts, media, and reusable page sections. Use the CMS link in the signed in site menu to open the editing workspace. If the link is not visible, ask the person who manages access to invite you or adjust your role. Most pages are built from a title, slug, metadata, and a sequence of reusable sections. Edit copy and media in the CMS, preview changes, then publish when the page is ready. Keep structural changes deliberate. If you need a new section type, navigation pattern, layout, or data backed block, ask the project maintainer to add it safely.",
|
|
31
|
+
"url": "/docs",
|
|
32
|
+
"routePatterns": [
|
|
33
|
+
"/docs",
|
|
34
|
+
"/docs/*"
|
|
35
|
+
],
|
|
36
|
+
"public": false,
|
|
37
|
+
"guideContext": null,
|
|
38
|
+
"updatedAt": "2026-11-14T04:05:26.115Z",
|
|
39
|
+
"hash": "sha256:cee1dfcd47c0cc800581e7557c206d725f783ebcab122825455ada421faf13b4"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"id": "docs:content/docs:mcp.mdx",
|
|
43
|
+
"title": "Connecting an assistant",
|
|
44
|
+
"source": "docs",
|
|
45
|
+
"text": "Some apps let signed in members connect an approved AI assistant through the app's /mcp endpoint. Only connect assistants you trust. The assistant should explain what it can read or change before you approve a task. If the connection fails, confirm you are signed in and ask the project maintainer whether assistant access is enabled for your role.",
|
|
46
|
+
"url": "/docs/mcp",
|
|
47
|
+
"routePatterns": [
|
|
48
|
+
"/docs/mcp",
|
|
49
|
+
"/docs/mcp/*"
|
|
50
|
+
],
|
|
51
|
+
"public": false,
|
|
52
|
+
"guideContext": null,
|
|
53
|
+
"updatedAt": "2026-11-14T04:05:26.116Z",
|
|
54
|
+
"hash": "sha256:9b7a64f4ce851af9f6664b4de67c6d92c4770228e76f06b3916f050d4b2f6467"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"id": "docs:content/docs:site-templates.mdx",
|
|
58
|
+
"title": "Reusable sections",
|
|
59
|
+
"source": "docs",
|
|
60
|
+
"text": "Templates are reusable Liquid templates for the public content site. Use them when a template fits the page section, layout, or page starter you need and the result should stay editable in the CMS. Discovery works from any directory: Installed templates are staged under site/seed/templates/ / : template.json is the draft Galley template payload. sample content.json carries registry sample data for review. page starters are Liquid templates that compose their sections with % render % tags; they also stage a page seed under site/seed/pages/ .json that points the page's design field at the starter. optional behavior sidecars are copied beside the staged payload when a template declares one. provenance.json records source URLs, generated hashes, dependencies, bindings, and install choices. Packs that read an EmDash collection through galley.dataSources use their manifest default collection when one is declared. Override or provide a required collection with bind : Theme manifests group a family's voice and vocabulary: palettes, sections, and page starter choices. A theme install stages the required dependencies plus the choices you select: palette is required when a theme lists more than one palette. page stages an EmDash page from a theme page starter key or exact template id. Use all optional only when you intentionally want every optional dependency staged. The site's structure is a shell: a layout with its welded nav and footer, selected by the site plan's capacity needs rather than by theme membership. raybase templates shell match nav items 5 footer links 12 theme raybase/lumen studio filters shells that fit and ranks them by voice fit. For one page sites, add anchor to filter to anchor tuned brand bar shells ( nav items 0 is valid — the logo block still renders at zero links). Then stage the chosen shell: activate stages an ephemeral activation.json work order beside the selected layout; during apply, selected templates are published, the active Galley layout pointer (and palette) is updated in the app database, and the work order is deleted. With the Astro/EmDash dev server running, apply staged templates: Without activate , templates are installed as draft templates. Structural pages point their design field at a page starter template; prose pages keep Portable Text in pages.content , where inline galley.block or galley.shared embeds are still supported. With shell add activate , templates:apply publishes the selected shell and section templates, upserts staged page seeds, and activates the layout for public rendering. Review staged JSON before apply and commit .raybase/templates.json , site/seed/templates/ , and site/seed/pages/ . The visual editor edits copy, fields, rich text, and Portable Text content. Page structure lives in Liquid: page starters compose sections with % render % tags, and structural changes remain agent/code work in Galley templates, resolved by installation (bare template ids, no per reference version pins).",
|
|
61
|
+
"url": "/docs/site-templates",
|
|
62
|
+
"routePatterns": [
|
|
63
|
+
"/docs/site-templates",
|
|
64
|
+
"/docs/site-templates/*"
|
|
65
|
+
],
|
|
66
|
+
"public": false,
|
|
67
|
+
"guideContext": null,
|
|
68
|
+
"updatedAt": "2026-11-14T04:05:26.116Z",
|
|
69
|
+
"hash": "sha256:9799eff846de2718833130cbdeda6309a584705c1a536fbe95647c7596fef05f"
|
|
70
|
+
}
|
|
71
|
+
]
|
|
72
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { RaybaseAgentWidget } from "@raybase/agent-ui";
|
|
2
|
+
import { guideConfig } from "../guide/config";
|
|
3
|
+
|
|
4
|
+
export function GuideWidget() {
|
|
5
|
+
return (
|
|
6
|
+
<RaybaseAgentWidget
|
|
7
|
+
agentName={guideConfig.agent?.name ?? "guide"}
|
|
8
|
+
enabled={guideConfig.enabled ?? true}
|
|
9
|
+
isSurfaceEnabled={isGuideSurfaceEnabled}
|
|
10
|
+
resolveSurface={resolveGuideSurface}
|
|
11
|
+
title={guideConfig.agent?.title ?? "Guide"}
|
|
12
|
+
/>
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
type GuideSurface = "app" | "docs";
|
|
17
|
+
|
|
18
|
+
function resolveGuideSurface(route: string): GuideSurface {
|
|
19
|
+
return route.startsWith("/docs") ? "docs" : "app";
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
function isGuideSurfaceEnabled(surface: string): boolean {
|
|
23
|
+
if (!isGuideSurface(surface)) return false;
|
|
24
|
+
return guideConfig.surfaces?.[surface]?.enabled ?? surface === "app";
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function isGuideSurface(surface: string): surface is GuideSurface {
|
|
28
|
+
return surface === "app" || surface === "docs";
|
|
29
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { GuideConfig } from "@raybase/guide";
|
|
2
|
+
|
|
3
|
+
export const guideConfig = {
|
|
4
|
+
enabled: true,
|
|
5
|
+
surfaces: {
|
|
6
|
+
app: { enabled: true, audience: "signed-in" },
|
|
7
|
+
docs: { enabled: true, audience: "signed-in" }
|
|
8
|
+
},
|
|
9
|
+
agent: {
|
|
10
|
+
name: "guide",
|
|
11
|
+
title: "Guide"
|
|
12
|
+
},
|
|
13
|
+
limits: {
|
|
14
|
+
publicIpHourlyRequests: 20,
|
|
15
|
+
publicIpHourlyOutputTokens: 12000,
|
|
16
|
+
publicDailyRequests: 200,
|
|
17
|
+
publicDailyOutputTokens: 60000,
|
|
18
|
+
signedInDailyRequests: 50,
|
|
19
|
+
maxCorpusSnippets: 8
|
|
20
|
+
}
|
|
21
|
+
} satisfies GuideConfig;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"generatedAt": "2026-11-14T04:05:33.795Z",
|
|
4
|
+
"sources": [
|
|
5
|
+
{
|
|
6
|
+
"kind": "guide",
|
|
7
|
+
"path": "content/guide"
|
|
8
|
+
}
|
|
9
|
+
],
|
|
10
|
+
"documents": [
|
|
11
|
+
{
|
|
12
|
+
"id": "faq:capability-map.md",
|
|
13
|
+
"title": "What Guide can do in this app",
|
|
14
|
+
"source": "faq",
|
|
15
|
+
"text": "Guide should answer from the checked in app docs, help knowledge, and explicit Agent actions registered by the app. It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform. When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task. Guide should not expose raw tool names, internal errors, JSON, SQL, source code details, admin/operator capabilities, secrets, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.",
|
|
16
|
+
"public": false,
|
|
17
|
+
"guideContext": "app-capability-map",
|
|
18
|
+
"updatedAt": "2026-11-14T04:05:26.038Z",
|
|
19
|
+
"hash": "sha256:9744984def63323f0435b3386509a0ff7d6f6a9986d1f159a1d04d037351ee53"
|
|
20
|
+
}
|
|
21
|
+
]
|
|
22
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: What Guide can do in this app
|
|
3
|
+
guideContext: app-capability-map
|
|
4
|
+
public: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Guide should answer from the checked-in app docs, help knowledge, and explicit Agent actions registered by the app.
|
|
8
|
+
|
|
9
|
+
It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform.
|
|
10
|
+
|
|
11
|
+
When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task.
|
|
12
|
+
|
|
13
|
+
Guide should not expose raw tool names, internal errors, JSON, SQL, source-code details, admin/operator capabilities, secrets, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: What Guide can do in this app
|
|
3
|
+
guideContext: app-capability-map
|
|
4
|
+
public: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
Guide should answer from the checked-in app docs, help knowledge, and explicit Agent actions registered by the app.
|
|
8
|
+
|
|
9
|
+
It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform.
|
|
10
|
+
|
|
11
|
+
In the Team Tasks starter, Guide can summarize visible projects and tasks, list visible projects and tasks, create projects, create tasks, update task fields, mark tasks done, archive tasks or projects, and list assignable users through narrow declared app actions that share the same policies and invariants as the UI workflow.
|
|
12
|
+
|
|
13
|
+
Guide should prefer archive over hard delete. It does not have hard-delete actions in its allow-list. If a user asks to permanently delete work, explain that deletion is handled from the app UI by someone with permission after the item is archived.
|
|
14
|
+
|
|
15
|
+
When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task.
|
|
16
|
+
|
|
17
|
+
Guide should not expose raw tool names, internal errors, JSON, SQL, source-code details, admin/operator capabilities, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import { useRouter } from "@tanstack/react-router";
|
|
2
|
+
import { RaybaseAgentWidget } from "@raybase/agent-ui";
|
|
3
|
+
import { useEffect } from "react";
|
|
4
|
+
import { guideConfig } from "../guide/config";
|
|
5
|
+
|
|
6
|
+
export function GuideWidget() {
|
|
7
|
+
const router = useRouter();
|
|
8
|
+
|
|
9
|
+
useEffect(() => {
|
|
10
|
+
const refreshData = () => {
|
|
11
|
+
void router.invalidate();
|
|
12
|
+
};
|
|
13
|
+
window.addEventListener("raybase:data-changed", refreshData);
|
|
14
|
+
return () => window.removeEventListener("raybase:data-changed", refreshData);
|
|
15
|
+
}, [router]);
|
|
16
|
+
|
|
17
|
+
return (
|
|
18
|
+
<RaybaseAgentWidget
|
|
19
|
+
agentName={guideConfig.agent?.name ?? "guide"}
|
|
20
|
+
enabled={guideConfig.enabled ?? true}
|
|
21
|
+
isSurfaceEnabled={isGuideSurfaceEnabled}
|
|
22
|
+
resolveSurface={resolveGuideSurface}
|
|
23
|
+
title={guideConfig.agent?.title ?? "Guide"}
|
|
24
|
+
/>
|
|
25
|
+
);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
type GuideSurface = "app" | "docs";
|
|
29
|
+
|
|
30
|
+
function resolveGuideSurface(route: string): GuideSurface {
|
|
31
|
+
return route.startsWith("/docs") ? "docs" : "app";
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
function isGuideSurfaceEnabled(surface: string): boolean {
|
|
35
|
+
if (!isGuideSurface(surface)) return false;
|
|
36
|
+
return guideConfig.surfaces?.[surface]?.enabled ?? surface === "app";
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function isGuideSurface(surface: string): surface is GuideSurface {
|
|
40
|
+
return surface === "app" || surface === "docs";
|
|
41
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { RaybaseAction } from "@raybase/core/actions";
|
|
2
|
+
import type { RaybaseEnv } from "@raybase/core/worker";
|
|
3
|
+
import { actions } from "../actions";
|
|
4
|
+
|
|
5
|
+
// Keep Guide on a narrow allow-list of app-declared actions.
|
|
6
|
+
export const guideActions = [
|
|
7
|
+
actions.workspaceSnapshot,
|
|
8
|
+
actions.listVisibleProjects,
|
|
9
|
+
actions.listVisibleTodos,
|
|
10
|
+
actions.createProject,
|
|
11
|
+
actions.createTodo,
|
|
12
|
+
actions.updateTodo,
|
|
13
|
+
actions.markTodoDone,
|
|
14
|
+
actions.archiveTodo,
|
|
15
|
+
actions.archiveProject,
|
|
16
|
+
actions.listAssignableUsers
|
|
17
|
+
] satisfies Array<RaybaseAction<any, any, RaybaseEnv>>;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { GuideConfig } from "@raybase/guide";
|
|
2
|
+
|
|
3
|
+
export const guideConfig = {
|
|
4
|
+
enabled: true,
|
|
5
|
+
surfaces: {
|
|
6
|
+
app: { enabled: true, audience: "signed-in" },
|
|
7
|
+
docs: { enabled: true, audience: "signed-in" }
|
|
8
|
+
},
|
|
9
|
+
agent: {
|
|
10
|
+
name: "guide",
|
|
11
|
+
title: "Guide"
|
|
12
|
+
},
|
|
13
|
+
limits: {
|
|
14
|
+
publicIpHourlyRequests: 20,
|
|
15
|
+
publicIpHourlyOutputTokens: 12000,
|
|
16
|
+
publicDailyRequests: 200,
|
|
17
|
+
publicDailyOutputTokens: 60000,
|
|
18
|
+
signedInDailyRequests: 50,
|
|
19
|
+
maxCorpusSnippets: 8
|
|
20
|
+
}
|
|
21
|
+
} satisfies GuideConfig;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"generatedAt": "2026-06-23T05:51:54.320Z",
|
|
4
|
+
"sources": [
|
|
5
|
+
{
|
|
6
|
+
"kind": "guide",
|
|
7
|
+
"path": "content/guide"
|
|
8
|
+
}
|
|
9
|
+
],
|
|
10
|
+
"documents": [
|
|
11
|
+
{
|
|
12
|
+
"id": "faq:capability-map.md",
|
|
13
|
+
"title": "What Guide can do in this app",
|
|
14
|
+
"source": "faq",
|
|
15
|
+
"text": "Guide should answer from the checked in app docs, help knowledge, and explicit Agent actions registered by the app. It can explain what the app tracks, where to go, how common workflows work, what the current user is allowed to do, and which tasks it can help perform. In the Team Tasks starter, Guide can summarize visible projects and tasks, list visible projects and tasks, create projects, create tasks, update task fields, mark tasks done, archive tasks or projects, and list assignable users through narrow declared app actions that share the same policies and invariants as the UI workflow. Guide should prefer archive over hard delete. It does not have hard delete actions in its allow list. If a user asks to permanently delete work, explain that deletion is handled from the app UI by someone with permission after the item is archived. When the app registers Agent actions, Guide may use those actions only after the user clearly asks and the action policy allows it. If no action is registered for a task, it can explain the workflow but should not claim it can perform the task. Guide should not expose raw tool names, internal errors, JSON, SQL, source code details, admin/operator capabilities, or implementation jargon. If context is missing or a tool fails, it should respond plainly, offer a useful next step, and ask one clarifying question only when needed.",
|
|
16
|
+
"public": false,
|
|
17
|
+
"guideContext": "app-capability-map",
|
|
18
|
+
"updatedAt": "2026-06-23T05:50:43.356Z",
|
|
19
|
+
"hash": "sha256:531e7a1160a7b21c50b7c5b6164873c7cde5114090dfc7aa544762c992548618"
|
|
20
|
+
}
|
|
21
|
+
]
|
|
22
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: raybase-openai-subscription
|
|
3
|
+
description: Install, configure, debug, test, or change Raybase's experimental ChatGPT/Codex subscription inference module, local relay, transport, health handling, or strict tool and response schemas.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Raybase OpenAI Subscription
|
|
7
|
+
|
|
8
|
+
Use this skill only for the explicitly selected `@raybase/openai-subscription`
|
|
9
|
+
module. It is developer guidance for an experimental integration, not a public
|
|
10
|
+
or stable OpenAI subscription API.
|
|
11
|
+
|
|
12
|
+
Read the reference that matches the task:
|
|
13
|
+
|
|
14
|
+
- [Module contract](references/module-contract.md): installed and runtime
|
|
15
|
+
integration, credential scope, relay/egress, secrets, health, and safe
|
|
16
|
+
operator guidance.
|
|
17
|
+
- [Structured outputs](references/structured-outputs.md): self-contained
|
|
18
|
+
Responses `text.format` and strict function-tool JSON Schema rules, examples,
|
|
19
|
+
Zod pitfalls, and reversible app adapters.
|
|
20
|
+
- [Compatibility and testing](references/compatibility-and-testing.md): a
|
|
21
|
+
secret-safe diagnostic ladder, error ownership, fixtures, and live smoke
|
|
22
|
+
criteria.
|
|
23
|
+
|
|
24
|
+
The module supports two declaration shapes:
|
|
25
|
+
|
|
26
|
+
- Installed: run `raybase modules add openai-subscription`. Omitted
|
|
27
|
+
`integration` means `"installed"`; preserve the generated provider/config,
|
|
28
|
+
credential-mode, background strategy, manifest, and egress contract.
|
|
29
|
+
- Runtime-registered: register the package through its public runtime API and
|
|
30
|
+
declare `{"enabled":true,"package":"@raybase/openai-subscription","integration":"runtime"}`.
|
|
31
|
+
Keep the package in production `dependencies`; declare
|
|
32
|
+
`RAYBASE_OPENAI_SUBSCRIPTION_KEY` in applicable Wrangler
|
|
33
|
+
`secrets.required` scopes and both local relay names in
|
|
34
|
+
`env.local-dev.secrets.required`. Do not adopt installed-only provider or
|
|
35
|
+
manifest checks.
|
|
36
|
+
|
|
37
|
+
Both enabled shapes start the dev-only Codex relay. Keep encryption keys and
|
|
38
|
+
all credential material exclusively in local/deployed Worker secrets. Never
|
|
39
|
+
put access tokens, refresh tokens, device secrets, identity tokens, relay
|
|
40
|
+
secrets, encryption keys, or account identifiers in source, logs, evidence,
|
|
41
|
+
browser storage, backups, fixtures, or handoff text.
|
|
42
|
+
|
|
43
|
+
Never silently fall back to Workers AI, OpenRouter, API-billed OpenAI, or
|
|
44
|
+
another chat provider. Embeddings may continue through their explicitly
|
|
45
|
+
configured path.
|
|
46
|
+
|
|
47
|
+
Preserve this non-blocking doctor information line exactly:
|
|
48
|
+
|
|
49
|
+
```text
|
|
50
|
+
info openai-subscription-usage-scope: Confirm that the selected credential scope matches the permitted use of the linked ChatGPT/Codex plan. Personal plans should not be pooled across unrelated users or tenants. For teams, use individually linked accounts or an appropriate Business, Enterprise, or API arrangement. Raybase informs but does not certify or enforce compliance.
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Do not infer compliance from app shape, user count, tenancy, routes, prose, or
|
|
54
|
+
source text. If health is genuinely `protocol_update_required`, tell the
|
|
55
|
+
operator to update to a newly published reviewed module version; never suggest
|
|
56
|
+
editing fixed endpoints or allowlists. An app-owned invalid tool or response
|
|
57
|
+
schema is not subscription protocol drift and must not poison module health.
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
# Compatibility and testing
|
|
2
|
+
|
|
3
|
+
Use this ladder to diagnose the narrowest failing contract without leaking
|
|
4
|
+
credentials or poisoning a healthy subscription lane.
|
|
5
|
+
|
|
6
|
+
## Diagnostic ladder
|
|
7
|
+
|
|
8
|
+
1. Start with a freshly linked eligible account and a minimal request with no
|
|
9
|
+
tools or response format. Confirm account/workspace/model routing and SSE.
|
|
10
|
+
2. Add one known-valid strict function tool whose parameters are a closed root
|
|
11
|
+
object. This isolates tool transport from the app's tool catalog.
|
|
12
|
+
3. Test final structured output separately with Responses `text.format`.
|
|
13
|
+
Function `parameters` and final response schemas share the strict subset but
|
|
14
|
+
occupy different request fields.
|
|
15
|
+
4. Replay the exact failing app schema. Record only HTTP status, the module's
|
|
16
|
+
sanitized and bounded fingerprint, request ID presence, counts, and sizes.
|
|
17
|
+
A bounded request ID may remain on the thrown error as an opaque support
|
|
18
|
+
correlation handle, but do not persist it automatically. Never record
|
|
19
|
+
request authorization, relay secrets, cookies, account IDs, raw messages or
|
|
20
|
+
parameter paths, bodies containing private input, or unrelated response
|
|
21
|
+
headers.
|
|
22
|
+
5. Classify ownership before changing health:
|
|
23
|
+
- auth/revocation/eligibility/account selection;
|
|
24
|
+
- rate limit or transient upstream failure;
|
|
25
|
+
- fixed transport envelope/header/stream drift;
|
|
26
|
+
- caller tool or response schema;
|
|
27
|
+
- app action validation after a valid model response.
|
|
28
|
+
6. For a parseable caller schema `400`, assert the public fingerprint is
|
|
29
|
+
sanitized and capped, the upstream message/parameter are absent, and
|
|
30
|
+
subscription health stays at its previous connected state. The app may
|
|
31
|
+
separately record its selected model attempt as failed.
|
|
32
|
+
7. After focused fixtures pass, complete a real subscription-backed app turn
|
|
33
|
+
through the local relay with the app's full tool catalog. Check the rendered
|
|
34
|
+
response and both health surfaces.
|
|
35
|
+
|
|
36
|
+
## Minimum fixtures
|
|
37
|
+
|
|
38
|
+
Cover all of these with exact schema assertions and restoration tests:
|
|
39
|
+
|
|
40
|
+
- closed root object with every property required;
|
|
41
|
+
- optional scalar represented with `null` and removed for the original app
|
|
42
|
+
validator;
|
|
43
|
+
- optional `const` using `anyOf` with `null`;
|
|
44
|
+
- root discriminated and plain unions normalized to one object;
|
|
45
|
+
- nested `oneOf` policy and nested `anyOf` output;
|
|
46
|
+
- selected-branch recursive restoration;
|
|
47
|
+
- arrays containing normalized objects;
|
|
48
|
+
- open records encoded as JSON strings and parsed back to objects;
|
|
49
|
+
- unconstrained values encoded as JSON strings and parsed back to every JSON
|
|
50
|
+
value kind;
|
|
51
|
+
- malformed/non-object roots rejected before transport;
|
|
52
|
+
- invalid JSON encodings rejected by the original validator;
|
|
53
|
+
- sanitized JSON refusal fixtures for both response-format
|
|
54
|
+
`invalid_json_schema` and tool `invalid_function_parameters` envelopes;
|
|
55
|
+
- `invalid_function_parameters` mapped without upstream detail or a health
|
|
56
|
+
incident;
|
|
57
|
+
- code-first/type-fallback normalization, hostile punctuation, a 32-character
|
|
58
|
+
token cap, and omission of overlong request IDs;
|
|
59
|
+
- empty, malformed, oversized, non-object, and detail-free `400` bodies mapped
|
|
60
|
+
to `protocol:unexpected_http_status_400` with
|
|
61
|
+
`protocol_update_required`;
|
|
62
|
+
- provider-level proof that a connected subscription remains connected with no
|
|
63
|
+
incident for a parseable request rejection, while an unclassifiable `400`
|
|
64
|
+
still transitions health.
|
|
65
|
+
|
|
66
|
+
## Request content verified 2026-08-11
|
|
67
|
+
|
|
68
|
+
A redacted local probe against the private subscription endpoint verified the
|
|
69
|
+
request-side image boundary independently of the public OpenAI API:
|
|
70
|
+
|
|
71
|
+
- Ordered image content uses `{ "type": "input_image", "image_url": ... }`.
|
|
72
|
+
Both an absolute HTTPS URL and a `data:image/...;base64,...` value completed.
|
|
73
|
+
- Inline PNG, JPEG, WEBP, and non-animated GIF samples completed.
|
|
74
|
+
- Omitting `detail` completed, as did explicit upstream probes for `auto`,
|
|
75
|
+
`low`, `high`, and `original`. Raybase's provider-neutral image contract does
|
|
76
|
+
not expose that knob, so the adapter always omits it; no semantic equivalence
|
|
77
|
+
between the values was inferred.
|
|
78
|
+
- `quality` is not an image-input field here. The endpoint rejected it with
|
|
79
|
+
`400 unknown_parameter` at the image part, and Raybase rejects it locally
|
|
80
|
+
rather than sending it.
|
|
81
|
+
- A valid 1x1 PNG carrying valid ancillary padding completed through
|
|
82
|
+
**19,573,864 encoded JSON request bytes** and **14,680,144 decoded image
|
|
83
|
+
bytes**. No rejection occurred below the probe's hard 20 MiB request-body
|
|
84
|
+
safety cap, so the exact private limit remains unverified. This proves a
|
|
85
|
+
request-body lower bound, not an image-decoding or useful-pixel bound.
|
|
86
|
+
|
|
87
|
+
Agent attachments remain deliberately more conservative: the default is 8 MiB
|
|
88
|
+
per file, before base64 expansion, plus the configured per-message attachment
|
|
89
|
+
count. Endpoint permissiveness does not widen those runtime admission limits.
|
|
90
|
+
|
|
91
|
+
Documented or adjacent content kinds that remain unsupported are Responses
|
|
92
|
+
`input_file` (file URL, file ID, or base64 file data), image-by-file-ID, Codex
|
|
93
|
+
`input_audio`/audio URLs, multimodal function-call outputs, assistant image
|
|
94
|
+
content, and image-generation/output-item families. Core exposes no image
|
|
95
|
+
result or stream event and this module does not author an image-generation
|
|
96
|
+
tool. The response-side test therefore asserts the gap precisely:
|
|
97
|
+
`image_generation_call` still fails closed as
|
|
98
|
+
`protocol:unknown_output_item`; it is not silently skipped.
|
|
99
|
+
|
|
100
|
+
## Live smoke requirements
|
|
101
|
+
|
|
102
|
+
Use a disposable app copy and the candidate Core CLI/package, not an old
|
|
103
|
+
workspace binary. Keep existing secret files out of output and source control.
|
|
104
|
+
For a runtime integration:
|
|
105
|
+
|
|
106
|
+
1. `raybase modules doctor` passes the runtime contract.
|
|
107
|
+
2. `raybase doctor`/`raybase check` contain no installed-only subscription
|
|
108
|
+
findings.
|
|
109
|
+
3. `raybase modules status --json` reports `integration: "runtime"`, enabled,
|
|
110
|
+
not scaffold-installed.
|
|
111
|
+
4. `raybase dev` starts the loopback relay and injects both local names.
|
|
112
|
+
5. A linked subscription turn reaches the expected model with the full app tool
|
|
113
|
+
set and renders a response.
|
|
114
|
+
6. Subscription health and app model health are healthy afterward.
|
|
115
|
+
7. Clean shutdown removes temporary relay values.
|
|
116
|
+
8. Removing the declaration restores the non-blocking undeclared-dependency
|
|
117
|
+
advisory and skips relay startup.
|
|
118
|
+
|
|
119
|
+
Do not replace the real linked turn with a mock when live acceptance is part of
|
|
120
|
+
the plan. If linking or upstream access is unavailable, record the exact blocker
|
|
121
|
+
and keep the implementation partial.
|
|
122
|
+
|
|
123
|
+
## Reconfirming Codex mapping
|
|
124
|
+
|
|
125
|
+
When Codex CLI behavior matters, inspect a pinned open-source tag. Trace
|
|
126
|
+
`--output-schema` from CLI configuration to the Responses request and compare it
|
|
127
|
+
with current official OpenAI docs. Do not infer an API parameter from an
|
|
128
|
+
internal Rust type name, and do not vendor a mutable Codex checkout into the
|
|
129
|
+
module skill.
|