create-theokit 1.6.0 → 1.7.0

package/package.json

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

package/templates/default/agents/chat.ts

@@ -1,5 +1,4 @@
 import { agent } from '@theokit/agents'
-import { defineSkillReadTool } from '@theokit/sdk'
 import { z } from 'zod'
 
 import { BASE_INSTRUCTIONS } from './prompts/instructions.js'
@@ -25,10 +24,9 @@ export default agent()
   .system(BASE_INSTRUCTIONS)
   .tool(weatherTool)
   .tool(currentTimeTool)
-  // `.skills([...])` registers the code-defined skill: the SDK lists its name + description in a
-  // `<skills>` block in every system prompt (cheap), so the model KNOWS the skill exists.
+  // `.skills([...])` wires the code-defined skill in ONE call: the SDK lists its name + description in a
+  // `<skills>` block every turn (cheap, so the model KNOWS it exists) AND auto-provisions a `skill_read`
+  // tool the model calls to load the full body on demand (so a long procedure only enters the prompt
+  // when needed). Pass a filesystem skill NAME (a string) here too; mix strings + createSkill freely.
   .skills([dailyBriefingSkill])
-  // `defineSkillReadTool` then gives the model a `skill_read` tool to load the full body on demand —
-  // so a long procedure only enters the prompt when the model actually needs it.
-  .tool(defineSkillReadTool([dailyBriefingSkill]))
   .build()

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

@@ -4,8 +4,8 @@ import { createSkill } from '@theokit/sdk'
  * A real, code-defined skill (`createSkill`) — 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
- * `defineSkillReadTool([...])`, which gives the model a `skill_read` tool. The model sees the skill's
- * name + description in every turn (cheap) and calls `skill_read('daily-briefing')` to load the full
+ * `.skills([dailyBriefingSkill])`. That one call lists the skill's name + description in a `<skills>`
+ * block every turn (cheap) AND provisions a `skill_read` tool the model calls to load the full
  * `instructions` only when it actually needs them — so long procedures don't bloat every prompt.
  *
  * Lives in `agents/skills/` — a semantic folder the route scanner skips, so it never becomes an endpoint.

package/templates/default/package.json.tmpl

@@ -15,8 +15,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "theokit": "^0.35.0",
-    "@theokit/agents": "^0.37.0",
+    "theokit": "^0.36.0",
+    "@theokit/agents": "^0.38.0",
     "@theokit/sdk": "^2.25.0",
     "@theokit/ui": "^1.0.0",
     "@usetheo/ui": "^0.14.0",