create-theokit 1.25.2 → 1.25.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-theokit",
-  "version": "1.25.2",
+  "version": "1.25.3",
   "type": "module",
   "description": "Scaffold a new TheoKit project",
   "repository": {

package/templates/default/dot-claude/rules/theokit-conventions.md

@@ -2,7 +2,7 @@
 
 ## Imports
 
-- Use `theokit/server/define` for defineRoute, defineAction, defineWebSocket
+- Use `theokit/server/define` for `route()`, `action()`, `websocket()`, `tool()`
 - Use `theokit/client` for theoFetch, createAppClient
 - Use `theokit/server/auth` for session/auth APIs
 - NEVER import from `theokit/dist/...` or `theokit/src/...`
@@ -13,12 +13,12 @@
 - Zod is the single source of truth for types and validation
 - Define schema ONCE with `z.object(...)`, derive types with `z.infer<>`
 - NEVER duplicate a Zod schema as a manual TypeScript interface
-- NEVER parse request body manually — use `body:` in defineRoute
+- NEVER parse request body manually — use `.body(z.object({ … }))` on the `route()` chain
 
 ## Routes
 
 - File at `server/routes/tasks/[id].ts` maps to `/api/tasks/:id`
-- Export HTTP method handlers: `export const GET = defineRoute({...})`
+- Export HTTP method handlers: `export const GET = route().policy('public').handler(…).build()`
 - Every method declares `policy` — who may call it. `'public'` is a valid answer and an explicit one;
   omitting it fails the build with the file named
 - Use `params: z.object({...})` for URL params, `body:` for request body

package/templates/default/dot-claude/skills/theokit-agents/SKILL.md

@@ -20,14 +20,14 @@ Create an `agents/<name>.ts` file at the project root. It is automatically serve
 
 ```typescript
 // agents/chat.ts
-import { defineAgent } from '@theokit/agents'
+import { AgentBuilder } from '@theokit/agents'
 import { z } from 'zod'
 
-export default defineAgent({
-  input: z.object({ message: z.string() }),
-  model: 'openrouter/openai/gpt-4o-mini',
-  system: 'You are a helpful assistant.',
-})
+export default AgentBuilder.create()
+  .input(z.object({ message: z.string() }))
+  .model('openrouter/openai/gpt-4o-mini')
+  .system('You are a helpful assistant.')
+  .build()
 ```
 
 The endpoint streams the ai-sdk `UIMessageStream` that `useAgent` (client hook) consumes.
@@ -205,7 +205,7 @@ Before writing custom tools, check if they already exist:
 
 ## Anti-patterns
 
-- NEVER call OpenAI/Anthropic/OpenRouter APIs directly — use `defineAgent` or `@Agent`
+- NEVER call OpenAI/Anthropic/OpenRouter APIs directly — use `AgentBuilder.create()`
 - NEVER reimplement tool calling loop — the SDK handles it
 - NEVER reimplement file/search/shell tools — use `@theokit/sdk-tools` (readFile, writeFile, search, etc.)
 - NEVER store conversations manually — SDK persistence is automatic (the SDK owns storage)

package/templates/default/dot-claude/skills/theokit-config/SKILL.md

@@ -135,4 +135,4 @@ Env vars are loaded from `.env` (dev) and `.env.production` (build). NEVER commi
 - NEVER hardcode secrets in theo.config.ts — use environment variables
 - NEVER set `security.csrf: false` in production
 - NEVER use `ssr: true` without understanding hydration (start with `false`)
-- NEVER add plugins that don't match `defineTheoPlugin` interface
+- NEVER add plugins that don't match `TheoPlugin` interface