create-theokit 1.11.1 → 1.11.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-theokit",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "type": "module",
   "description": "Scaffold a new TheoKit project",
   "license": "Apache-2.0",

package/templates/default/agents/skills/daily-briefing.ts

@@ -1,7 +1,7 @@
-import { createSkill } from '@theokit/sdk'
+import { Skill } from '@theokit/sdk'
 
 /**
- * A real, code-defined skill (`createSkill`) — a documented procedure the MODEL can pull in on demand.
+ * A real, code-defined skill (`Skill.create`) — a documented procedure the MODEL can pull in on demand.
  *
  * Unlike a loose Markdown note, this is wired into the agent: `agents/chat.ts` passes it to
  * `.skills([dailyBriefingSkill])`. That one call lists the skill's name + description in a `<skills>`
@@ -10,7 +10,7 @@ import { createSkill } from '@theokit/sdk'
  *
  * Lives in `agents/skills/` — a semantic folder the route scanner skips, so it never becomes an endpoint.
  */
-export const dailyBriefingSkill = createSkill({
+export const dailyBriefingSkill = Skill.create({
   name: 'daily-briefing',
   description:
     "Produce a short 'good morning' briefing (today's date, the weather, and a one-line nudge).",

package/templates/default/docs/ARCHITECTURE.md

@@ -15,7 +15,7 @@ folders it composes (prompts, tools, skills) live together under `agents/`, with
 │   ├── tools/              #   tools the agent can call
 │   │   ├── weather.ts      #     remote — current weather via open-meteo (HTTP)
 │   │   └── current-time.ts #     local — date/time in an IANA timezone (no network)
-│   └── skills/             #   procedures the model loads on demand (createSkill)
+│   └── skills/             #   procedures the model loads on demand (Skill.create)
 │       └── daily-briefing.ts    #   a real skill: time → weather → a one-line nudge
 ├── app/                    # Frontend (web surface). tui → tui/, desktop → frontend/
 │   ├── page.tsx            #   the `/` route — composition root (lays out the components + the hook)
@@ -59,13 +59,13 @@ export default agent()
   .system(BASE_INSTRUCTIONS)   // agents/prompts/instructions.ts
   .tool(weatherTool)           // agents/tools/weather.ts
   .tool(currentTimeTool)       // agents/tools/current-time.ts
-  .tool(defineSkillReadTool([dailyBriefingSkill]))  // agents/skills/daily-briefing.ts
+  .skills([dailyBriefingSkill])                 // agents/skills/daily-briefing.ts
   .build()
 ```
 
 Grow the agent by editing its neighbours, not by inflating `chat.ts`: persona → `prompts/instructions.ts`,
 a new capability → `tools/<name>.ts` (then `.tool(<name>Tool)`), a documented procedure → a
-`createSkill(...)` in `skills/<name>.ts` (add it to the `defineSkillReadTool([...])` list). A **skill** is
+`Skill.create(...)` in `skills/<name>.ts` (add it to the `.skills([...])` list). A **skill** is
 loaded by the model on demand via the `skill_read` tool, so long procedures don't bloat every prompt. Add a
 **second agent** as another `agents/<name>.ts`.
 

package/templates/default/docs/CUSTOMIZATION.md

@@ -7,7 +7,7 @@ Common changes, and where they go. See [ARCHITECTURE](./ARCHITECTURE.md) for the
 | Change the model | `agents/chat.ts` (`.model(...)`) + the label in `shared/agent.ts` |
 | Change the persona / rules | `agents/prompts/instructions.ts` |
 | Add a tool (an action the agent can take) | new `agents/tools/<name>.ts`, then `.tool(<name>Tool)` in `agents/chat.ts` |
-| Add a skill (a procedure the model loads on demand) | `createSkill(...)` in `agents/skills/<name>.ts`, then add it to `defineSkillReadTool([...])` in `agents/chat.ts` |
+| Add a skill (a procedure the model loads on demand) | `Skill.create(...)` in `agents/skills/<name>.ts`, then add it to `.skills([...])` in `agents/chat.ts` |
 | Add a second agent | new `agents/<name>.ts` → auto-served at `/api/agents/<name>`, bind with `useAgent('<name>')` |
 | Change the greeting / app name | `shared/agent.ts` |
 | Add a backend route | `server/routes/<name>.ts` |

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

@@ -156,12 +156,12 @@ Before writing custom tools, check if they already exist:
 
 | Package | What it provides | When to use |
 |---------|-----------------|-------------|
-| `@theokit/sdk` | `Agent.create()`, `defineTool()` (primitive), `Run.stream()` | Core agent runtime — always installed |
+| `@theokit/sdk` | `Agent.create()`, `Tool.create()` (primitive), `Run.stream()` | Core agent runtime — always installed |
 | `@theokit/sdk-tools` | Ready-made tools: `createReadFileTool`, `createWriteFileTool`, `createSearchTextTool`, `createGlobTool`, `createShellTool`, etc. | **Check here FIRST** before writing custom tools for coding agents |
 | `@theokit/di-agent` | DI-powered agent with decorator injection | When using dependency injection pattern |
 | `@theokit/di` | Core DI container (`@Injectable`, `@Inject`) | When `@theokit/di-agent` needs explicit bindings |
 
-**`defineTool()` in `@theokit/sdk` is the primitive API.** For coding agents, `@theokit/sdk-tools` has batteries-included tools that wrap `defineTool()` with file system access, search, shell execution, etc. Don't reimplement what `sdk-tools` already provides.
+**`Tool.create()` in `@theokit/sdk` is the primitive API.** For coding agents, `@theokit/sdk-tools` has batteries-included tools that wrap `Tool.create()` with file system access, search, shell execution, etc. Don't reimplement what `sdk-tools` already provides.
 
 ## Rules
 

package/templates/default/package.json.tmpl

@@ -15,8 +15,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "theokit": "^0.39.1",
-    "@theokit/agents": "^0.38.1",
+    "theokit": "^0.40.0",
+    "@theokit/agents": "^0.39.0",
     "@theokit/sdk": "^2.25.0",
     "@theokit/ui": "^1.0.0",
     "@usetheo/ui": "^0.14.0",