feat: improve docs running

pull/715/head
Travis Fischer 2025-06-28 01:43:42 -05:00
rodzic 3f34cdccae
commit 35aaba6019
9 zmienionych plików z 343 dodań i 288 usunięć

Wyświetl plik

@ -34,8 +34,8 @@
"@agentic/platform-hono": "workspace:*",
"@agentic/platform-types": "workspace:*",
"@agentic/platform-validators": "workspace:*",
"@dicebear/collection": "^9.2.3",
"@dicebear/core": "^9.2.3",
"@dicebear/collection": "catalog:",
"@dicebear/core": "catalog:",
"@fisch0920/drizzle-orm": "catalog:",
"@fisch0920/drizzle-zod": "catalog:",
"@hono/node-server": "catalog:",

Wyświetl plik

@ -25,7 +25,7 @@
"@agentic/platform-core": "workspace:*",
"@agentic/platform-types": "workspace:*",
"@agentic/platform-validators": "workspace:*",
"@date-fns/utc": "^2.1.0",
"@date-fns/utc": "catalog:",
"@number-flow/react": "catalog:",
"@pmndrs/assets": "catalog:",
"@radix-ui/react-dropdown-menu": "catalog:",
@ -45,7 +45,7 @@
"canvas-confetti": "catalog:",
"class-variance-authority": "catalog:",
"clsx": "catalog:",
"date-fns": "^4.1.0",
"date-fns": "catalog:",
"hast-util-to-jsx-runtime": "catalog:",
"ky": "catalog:",
"lucide-react": "catalog:",

19
docs/package.json 100644
Wyświetl plik

@ -0,0 +1,19 @@
{
"name": "docs",
"private": true,
"author": "Travis Fischer <travis@transitivebullsh.it>",
"license": "AGPL-3.0",
"repository": {
"type": "git",
"url": "git+https://github.com/transitive-bullshit/agentic.git"
},
"type": "module",
"scripts": {
"docs": "mint dev",
"test": "run-s test:*",
"test:broken-links": "mint broken-links"
},
"devDependencies": {
"mint": "catalog:"
}
}

Wyświetl plik

@ -7,7 +7,7 @@
"type": "git",
"url": "git+https://github.com/transitive-bullshit/agentic.git"
},
"packageManager": "pnpm@10.12.3",
"packageManager": "pnpm@10.12.4",
"engines": {
"node": ">=20"
},
@ -15,7 +15,7 @@
"scripts": {
"build": "turbo build --filter=!web",
"dev": "turbo dev --continue --filter=!./examples/*",
"docs": "cd docs && mint dev",
"docs": "turbo run docs",
"clean": "turbo clean",
"fix": "run-s fix:*",
"fix:format": "prettier --write \"**/*.{js,ts,tsx}\"",
@ -41,7 +41,6 @@
"eslint-plugin-drizzle": "catalog:",
"knip": "catalog:",
"lint-staged": "catalog:",
"mint": "^4.1.97",
"npm-run-all2": "catalog:",
"only-allow": "catalog:",
"prettier": "catalog:",

Wyświetl plik

@ -27,7 +27,7 @@
"test:unit": "vitest run"
},
"dependencies": {
"@sindresorhus/slugify": "^2.2.1",
"@sindresorhus/slugify": "catalog:",
"decircular": "catalog:",
"is-obj": "catalog:",
"parse-json": "catalog:",

Plik diff jest za duży Load Diff

Wyświetl plik

@ -3,58 +3,67 @@ packages:
- apps/*
- examples/*
- packages/fixtures/valid/*
- docs
ignoredBuiltDependencies:
- "@fisch0920/config"
- puppeteer
onlyBuiltDependencies:
- "@sentry/cli"
catalog:
'@agentic/core': ^7.6.7
'@agentic/serper': ^7.6.7
'@ai-sdk/openai': ^1.3.22
'@apideck/better-ajv-errors': ^0.3.6
'@clack/prompts': 0.11.0
'@cloudflare/workers-types': ^4.20250620.0
'@commander-js/extra-typings': ^14.0.0
'@dotenvx/dotenvx': ^1.45.1
'@edge-runtime/vm': ^5.0.0
'@fisch0920/config': ^1.1.3
'@fisch0920/drizzle-orm': ^0.43.7
'@fisch0920/drizzle-zod': ^0.7.9
'@hono/mcp': ^0.1.0
'@hono/node-server': 1.14.4
'@hono/sentry': ^1.2.2
'@hono/zod-openapi': ^0.19.8
'@hono/zod-validator': ^0.7.0
'@modelcontextprotocol/sdk': ^1.13.0
'@number-flow/react': ^0.5.10
'@paralleldrive/cuid2': ^2.2.2
'@pmndrs/assets': ^1.7.0
'@radix-ui/react-dropdown-menu': ^2.1.15
'@radix-ui/react-label': ^2.1.7
'@radix-ui/react-slot': ^1.2.3
'@radix-ui/react-tabs': ^1.1.12
'@radix-ui/react-tooltip': ^1.2.7
'@react-email/components': ^0.1.0
'@react-three/cannon': ^6.6.0
'@react-three/drei': ^10.2.0
'@react-three/fiber': ^9.1.2
'@react-three/postprocessing': ^3.0.4
'@react-three/rapier': ^2.1.0
'@redocly/openapi-core': ^1.34.3
'@sentry/cli': ^2.46.0
'@sentry/cloudflare': ^9.30.0
'@sentry/core': ^9.30.0
'@sentry/node': ^9.30.0
'@standard-schema/spec': ^1.0.0
'@tailwindcss/postcss': ^4.1.10
'@tailwindcss/typography': ^0.5.16
'@tanstack/react-form': ^1.12.3
'@tanstack/react-query': ^5.80.10
'@tanstack/react-query-devtools': ^5.80.10
'@types/canvas-confetti': ^1.9.0
'@types/ms': ^2.1.0
'@types/node': ^24.0.4
'@types/react': ^19.1.8
'@types/react-dom': ^19.1.6
'@types/semver': ^7.7.0
'@types/three': ^0.177.0
"@agentic/core": ^7.6.7
"@agentic/serper": ^7.6.7
"@ai-sdk/openai": ^1.3.22
"@apideck/better-ajv-errors": ^0.3.6
"@clack/prompts": 0.11.0
"@cloudflare/workers-types": ^4.20250620.0
"@commander-js/extra-typings": ^14.0.0
"@date-fns/utc": ^2.1.0
"@dicebear/collection": ^9.2.3
"@dicebear/core": ^9.2.3
"@dotenvx/dotenvx": ^1.45.1
"@edge-runtime/vm": ^5.0.0
"@fisch0920/config": ^1.1.3
"@fisch0920/drizzle-orm": ^0.43.7
"@fisch0920/drizzle-zod": ^0.7.9
"@hono/mcp": ^0.1.0
"@hono/node-server": 1.14.4
"@hono/sentry": ^1.2.2
"@hono/zod-openapi": ^0.19.8
"@hono/zod-validator": ^0.7.0
"@modelcontextprotocol/sdk": ^1.13.0
"@number-flow/react": ^0.5.10
"@paralleldrive/cuid2": ^2.2.2
"@pmndrs/assets": ^1.7.0
"@radix-ui/react-dropdown-menu": ^2.1.15
"@radix-ui/react-label": ^2.1.7
"@radix-ui/react-slot": ^1.2.3
"@radix-ui/react-tabs": ^1.1.12
"@radix-ui/react-tooltip": ^1.2.7
"@react-email/components": ^0.1.0
"@react-three/cannon": ^6.6.0
"@react-three/drei": ^10.2.0
"@react-three/fiber": ^9.1.2
"@react-three/postprocessing": ^3.0.4
"@react-three/rapier": ^2.1.0
"@redocly/openapi-core": ^1.34.3
"@sentry/cli": ^2.46.0
"@sentry/cloudflare": ^9.30.0
"@sentry/core": ^9.30.0
"@sentry/node": ^9.30.0
"@sindresorhus/slugify": ^2.2.1
"@standard-schema/spec": ^1.0.0
"@tailwindcss/postcss": ^4.1.10
"@tailwindcss/typography": ^0.5.16
"@tanstack/react-form": ^1.12.3
"@tanstack/react-query": ^5.80.10
"@tanstack/react-query-devtools": ^5.80.10
"@types/canvas-confetti": ^1.9.0
"@types/ms": ^2.1.0
"@types/node": ^24.0.6
"@types/react": ^19.1.8
"@types/react-dom": ^19.1.6
"@types/semver": ^7.7.0
"@types/three": ^0.177.0
agents: ^0.0.95
ai: ^4.3.15
ajv: ^8.17.1
@ -69,6 +78,7 @@ catalog:
clsx: ^2.1.1
commander: ^14.0.0
conf: ^14.0.0
date-fns: ^4.1.0
decamelize: ^6.0.0
decircular: ^1.0.0
del-cli: ^6.0.0
@ -76,7 +86,7 @@ catalog:
drizzle-kit: ^0.31.1
drizzle-orm: ^0.44.2
email-validator: ^2.0.4
eslint: ^9.29.0
eslint: ^9.30.0
eslint-plugin-drizzle: ^0.2.3
eventid: ^2.0.1
exit-hook: 4.0.0
@ -93,6 +103,7 @@ catalog:
ky: 1.8.1
lint-staged: ^16.1.2
lucide-react: ^0.518.0
mint: ^4.1.97
motion: ^12.18.1
ms: ^2.1.3
next: ^15.3.4
@ -112,7 +123,7 @@ catalog:
postcss: ^8.5.6
postgres: ^3.4.7
posthog-js: ^1.255.0
prettier: ^3.6.0
prettier: ^3.6.2
react: ^19.1.0
react-dom: ^19.1.0
react-email: ^4.0.16
@ -145,9 +156,3 @@ catalog:
zod: ^3.25.67
zod-to-json-schema: ^3.24.5
zod-validation-error: ^3.5.2
ignoredBuiltDependencies:
- '@fisch0920/config'
onlyBuiltDependencies:
- '@sentry/cli'

Wyświetl plik

@ -17,21 +17,11 @@
- webapp
- consider a PrettyJson component which displays json but links to resources
- stripe
- stripe checkout for changing plans? (need to at least be able to upgrade)
- double check stripe upgrade flow and add fireworks
- should we bypass stripe for `free` plans to increase conversions?
- handle browser back/forward with `?next=`
- add some social proof to signup page
- empty dashboard; add some CTAs
- **API gateway**
- oauth flow
- https://docs.scalekit.com/guides/mcp/oauth
- custom oauth flow might need to use separate domains per project instead of separate pathnames?
- since the .well-known routes and standard oauth 2.1 routes are all at the top-level?
- **e2e tests for usage tracking and reporting**
- marketplace
- may need a different flag besides `private` for inclusion on the marketplace
- projects may be public but not accepted into the marketplace?
- => **punt on this for mvp**
- docs
- main readme
- sub readmes
@ -42,9 +32,20 @@
- simplify `AgenticToolClient` and only require one package per TS LLM SDK
- `createAISDKToolsFromIdentifier(projectIdentifier)`
- add really strict free rate-limits to `@agentic/search`
-
## TODO: Post-MVP
- **API gateway**
- oauth flow
- https://docs.scalekit.com/guides/mcp/oauth
- custom oauth flow might need to use separate domains per project instead of separate pathnames?
- since the .well-known routes and standard oauth 2.1 routes are all at the top-level?
- **e2e tests for usage tracking and reporting**
- marketplace
- may need a different flag besides `private` for inclusion on the marketplace
- projects may be public but not accepted into the marketplace?
- => **punt on this for mvp**
- **website**
- llms.txt and llms.txt for all projects
- first-party deployment hosting

Wyświetl plik

@ -35,6 +35,10 @@
"dev": {
"cache": false,
"persistent": true
},
"docs": {
"cache": false,
"persistent": true
}
}
}