theokit 0.76.3 → 0.77.1

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.
Files changed (113) hide show
  1. package/README.md +59 -0
  2. package/dist/{actions-virtual-module-52O6HJZT.js → actions-virtual-module-UIX5YWZR.js} +4 -4
  3. package/dist/{actions-virtual-module-HS4W7HQU.js → actions-virtual-module-V5Q4XVL5.js} +2 -2
  4. package/dist/{add-DOR7HORT.js → add-NFDL4OJ7.js} +2 -2
  5. package/dist/{agent-HCK5RHH7.js → agent-MJWQRSJ2.js} +2 -2
  6. package/dist/{app-typed-client-CJCOALMM.js → app-typed-client-6FQB5FQO.js} +4 -4
  7. package/dist/{app-typed-client-BWITJLJA.js → app-typed-client-JCBQGPMP.js} +2 -2
  8. package/dist/{build-Y3CWTWP6.js → build-Y457R5HE.js} +10 -63
  9. package/dist/build-Y457R5HE.js.map +1 -0
  10. package/dist/{chunk-W2I6L4IJ.js → chunk-35OI2TKT.js} +2 -2
  11. package/dist/{chunk-OIYSUQM7.js → chunk-3TCWOHLY.js} +4 -2
  12. package/dist/{chunk-OIYSUQM7.js.map → chunk-3TCWOHLY.js.map} +1 -1
  13. package/dist/{chunk-UQQQ3V43.js → chunk-3XR6CBUA.js} +65 -5
  14. package/dist/chunk-3XR6CBUA.js.map +1 -0
  15. package/dist/{chunk-BTDTHXUI.js → chunk-BFDEEJOK.js} +1 -1
  16. package/dist/{chunk-BTDTHXUI.js.map → chunk-BFDEEJOK.js.map} +1 -1
  17. package/dist/{chunk-XI4FALFZ.js → chunk-E22GPCCO.js} +24 -1
  18. package/dist/chunk-E22GPCCO.js.map +1 -0
  19. package/dist/{chunk-OED37LE5.js → chunk-GNV34JMI.js} +37 -3
  20. package/dist/chunk-GNV34JMI.js.map +1 -0
  21. package/dist/{chunk-2SGNODVJ.js → chunk-HNALEGOL.js} +40 -10
  22. package/dist/chunk-HNALEGOL.js.map +1 -0
  23. package/dist/{chunk-ZQJORKBM.js → chunk-HZAXFD55.js} +49 -2
  24. package/dist/chunk-HZAXFD55.js.map +1 -0
  25. package/dist/{chunk-JVXDEIT4.js → chunk-I2IDWM26.js} +33 -9
  26. package/dist/chunk-I2IDWM26.js.map +1 -0
  27. package/dist/{chunk-PVCXREGE.js → chunk-KQBY62AE.js} +2 -2
  28. package/dist/{chunk-BXQCJJPT.js → chunk-N5YHENWJ.js} +2 -2
  29. package/dist/{chunk-FEK25JUL.js → chunk-OKFRGAYZ.js} +67 -9
  30. package/dist/chunk-OKFRGAYZ.js.map +1 -0
  31. package/dist/{chunk-XDLFOATW.js → chunk-OSSNCUS6.js} +4 -4
  32. package/dist/{chunk-C2BRSL4W.js → chunk-PQWVT6JC.js} +11 -1
  33. package/dist/{chunk-C2BRSL4W.js.map → chunk-PQWVT6JC.js.map} +1 -1
  34. package/dist/chunk-V3LMUQSB.js +98 -0
  35. package/dist/chunk-V3LMUQSB.js.map +1 -0
  36. package/dist/{chunk-47FFT43U.js → chunk-YH5CDWLU.js} +25 -1
  37. package/dist/chunk-YH5CDWLU.js.map +1 -0
  38. package/dist/cli/index.js +13 -13
  39. package/dist/{db-ZWDKD57T.js → db-5WOK6HA2.js} +3 -3
  40. package/dist/{define-middleware-BOHpPOBs.d.ts → define-middleware-D7LFaTv-.d.ts} +27 -2
  41. package/dist/{dev-R2ZYHZV4.js → dev-N5LQFLBR.js} +9 -7
  42. package/dist/dev-N5LQFLBR.js.map +1 -0
  43. package/dist/docker-OTV3M54A.js +130 -0
  44. package/dist/docker-OTV3M54A.js.map +1 -0
  45. package/dist/{generate-6F24XT72.js → generate-4DY3MEYB.js} +73 -41
  46. package/dist/generate-4DY3MEYB.js.map +1 -0
  47. package/dist/{index-DfsJ3Qhk.d.ts → index-C2lcEI-4.d.ts} +2 -2
  48. package/dist/index.d.ts +1 -0
  49. package/dist/index.js +5 -4
  50. package/dist/index.js.map +1 -1
  51. package/dist/{info-IPMW56PI.js → info-ELSPSCXK.js} +3 -3
  52. package/dist/{internal-api-6RAOYIET.js → internal-api-5FTPYSEQ.js} +2 -2
  53. package/dist/{internal-api-YGFPLQ4E.js → internal-api-H3C2ID6N.js} +4 -4
  54. package/dist/{job-backend-WvUs5rO1.d.ts → job-backend-BX-PwnZW.d.ts} +25 -0
  55. package/dist/{load-config-USRR4GXP.js → load-config-SKLFH7YL.js} +3 -3
  56. package/dist/{mcp-FBXEX45H.js → mcp-3ENI2IPS.js} +3 -3
  57. package/dist/{openapi-CA3E3LZH.js → openapi-OVXYHZ2S.js} +3 -3
  58. package/dist/{preview-DLIVPM7A.js → preview-Y3JNYOFK.js} +3 -3
  59. package/dist/{routes-BJ7GGRCV.js → routes-UNJ77IQU.js} +3 -3
  60. package/dist/{schema-FBM2UH72.js → schema-2EAIJFWA.js} +2 -2
  61. package/dist/server/define/index.d.ts +5 -4
  62. package/dist/server/define/index.js +1 -1
  63. package/dist/server/http/index.d.ts +4 -3
  64. package/dist/server/http/index.js +3 -3
  65. package/dist/server/index.d.ts +5 -5
  66. package/dist/server/index.js +7 -5
  67. package/dist/server/index.js.map +1 -1
  68. package/dist/server/jobs/index.d.ts +75 -6
  69. package/dist/server/jobs/index.js +4 -2
  70. package/dist/{server-boundary-EKIGYL7B.js → server-boundary-5ZTBC2KF.js} +2 -2
  71. package/dist/{server-boundary-IDWIB24L.js → server-boundary-DTF6ZEUO.js} +4 -4
  72. package/dist/{start-LNT5UVSY.js → start-EJFYT7ZU.js} +13 -37
  73. package/dist/start-EJFYT7ZU.js.map +1 -0
  74. package/dist/vite-plugin/index.js +5 -4
  75. package/dist/{vite-plugin-LE42ZIGV.js → vite-plugin-MNZHNOM4.js} +6 -6
  76. package/package.json +3 -3
  77. package/dist/build-Y3CWTWP6.js.map +0 -1
  78. package/dist/chunk-2SGNODVJ.js.map +0 -1
  79. package/dist/chunk-47FFT43U.js.map +0 -1
  80. package/dist/chunk-FEK25JUL.js.map +0 -1
  81. package/dist/chunk-JVXDEIT4.js.map +0 -1
  82. package/dist/chunk-OED37LE5.js.map +0 -1
  83. package/dist/chunk-UQQQ3V43.js.map +0 -1
  84. package/dist/chunk-XI4FALFZ.js.map +0 -1
  85. package/dist/chunk-ZQJORKBM.js.map +0 -1
  86. package/dist/dev-R2ZYHZV4.js.map +0 -1
  87. package/dist/docker-LZZB4D5E.js +0 -102
  88. package/dist/docker-LZZB4D5E.js.map +0 -1
  89. package/dist/generate-6F24XT72.js.map +0 -1
  90. package/dist/start-LNT5UVSY.js.map +0 -1
  91. /package/dist/{actions-virtual-module-52O6HJZT.js.map → actions-virtual-module-UIX5YWZR.js.map} +0 -0
  92. /package/dist/{actions-virtual-module-HS4W7HQU.js.map → actions-virtual-module-V5Q4XVL5.js.map} +0 -0
  93. /package/dist/{add-DOR7HORT.js.map → add-NFDL4OJ7.js.map} +0 -0
  94. /package/dist/{agent-HCK5RHH7.js.map → agent-MJWQRSJ2.js.map} +0 -0
  95. /package/dist/{app-typed-client-CJCOALMM.js.map → app-typed-client-6FQB5FQO.js.map} +0 -0
  96. /package/dist/{app-typed-client-BWITJLJA.js.map → app-typed-client-JCBQGPMP.js.map} +0 -0
  97. /package/dist/{chunk-W2I6L4IJ.js.map → chunk-35OI2TKT.js.map} +0 -0
  98. /package/dist/{chunk-PVCXREGE.js.map → chunk-KQBY62AE.js.map} +0 -0
  99. /package/dist/{chunk-BXQCJJPT.js.map → chunk-N5YHENWJ.js.map} +0 -0
  100. /package/dist/{chunk-XDLFOATW.js.map → chunk-OSSNCUS6.js.map} +0 -0
  101. /package/dist/{db-ZWDKD57T.js.map → db-5WOK6HA2.js.map} +0 -0
  102. /package/dist/{info-IPMW56PI.js.map → info-ELSPSCXK.js.map} +0 -0
  103. /package/dist/{internal-api-6RAOYIET.js.map → internal-api-5FTPYSEQ.js.map} +0 -0
  104. /package/dist/{internal-api-YGFPLQ4E.js.map → internal-api-H3C2ID6N.js.map} +0 -0
  105. /package/dist/{load-config-USRR4GXP.js.map → load-config-SKLFH7YL.js.map} +0 -0
  106. /package/dist/{mcp-FBXEX45H.js.map → mcp-3ENI2IPS.js.map} +0 -0
  107. /package/dist/{openapi-CA3E3LZH.js.map → openapi-OVXYHZ2S.js.map} +0 -0
  108. /package/dist/{preview-DLIVPM7A.js.map → preview-Y3JNYOFK.js.map} +0 -0
  109. /package/dist/{routes-BJ7GGRCV.js.map → routes-UNJ77IQU.js.map} +0 -0
  110. /package/dist/{schema-FBM2UH72.js.map → schema-2EAIJFWA.js.map} +0 -0
  111. /package/dist/{server-boundary-EKIGYL7B.js.map → server-boundary-5ZTBC2KF.js.map} +0 -0
  112. /package/dist/{server-boundary-IDWIB24L.js.map → server-boundary-DTF6ZEUO.js.map} +0 -0
  113. /package/dist/{vite-plugin-LE42ZIGV.js.map → vite-plugin-MNZHNOM4.js.map} +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/cleanup/cleanup.ts"],"sourcesContent":["/**\n * State cleanup utilities (Phase 2 of\n *\n * - `cleanOutDir` — Astro pattern: empty a directory except a skip list,\n * used at `theokit build` start.\n * - `gcAgentRegistry` — Nuxt LRU pattern: delete oldest agent dirs when\n * count exceeds cap, used at `theokit dev` startup.\n *\n * EC-3 (MUST FIX, CRITICAL): cleanOutDir refuses to wipe anything outside\n * the current cwd. Prevents catastrophic `distDir: '/'` data loss.\n * EC-9 (SHOULD TEST): gcAgentRegistry handles dirs with mtime=0 (Docker overlay).\n * EC-11 (SHOULD TEST): cleanOutDir normalizes trailing-slash in skip basenames.\n * EC-12 (SHOULD TEST): cleanOutDir catches EROFS and continues.\n */\n\nimport { promises as fs } from 'node:fs'\nimport { basename, resolve as resolvePath, sep } from 'node:path'\n\nimport type {\n CleanOutDirOptions,\n CleanOutDirResult,\n GcAgentRegistryOptions,\n GcAgentRegistryResult,\n} from './cleanup-types.js'\n\nconst DEFAULT_SKIP = ['.git', '.gitkeep', '.gitignore']\n// DEFAULT_MAX_AGENTS removed in Phase 7 — gcAgentRegistry is a tombstone.\n\n/**\n * `.theokit/` holds two unrelated things: what `theokit build` writes (the default `distDir`), and\n * the agent context the framework and `@theokit/sdk` read at runtime. These lists name the second\n * kind so the build stops deleting it (#1079) and the generated ignore files can tell the two apart\n * (#1075, #1069).\n */\n\n/**\n * Entries a person writes and the project versions and ships: the instruction file, rules,\n * personalities, skills, sub-agents, slash commands and hooks.\n *\n * `packages/create-theokit/templates/default/_gitignore` un-ignores the same names; a test keeps\n * the two in step, because create-theokit cannot import from this package.\n */\nexport const AUTHORED_AGENT_CONTEXT = [\n 'THEO.md',\n 'rules',\n 'personalities',\n 'skills',\n 'agents',\n 'commands',\n 'hooks.json',\n] as const\n\n/**\n * Entries the agent runtime or a single developer writes: memory, local overrides, credentials,\n * trust and approval records, plugin bundles. A build keeps them; git and the image leave them out,\n * since several hold tokens.\n */\nconst LOCAL_AGENT_STATE = [\n 'THEO.local.md',\n 'AGENTS.local.md',\n 'memory',\n 'context',\n 'context.json',\n 'config.json',\n 'settings.json',\n 'mcp.json',\n 'hooks',\n 'plugins',\n 'cron',\n 'profiles',\n 'auth.json',\n 'mcp-tokens.json',\n 'credential-pool.json',\n 'tool-permissions.json',\n 'hook-approvals.json',\n] as const\n\nfunction normalizeSkipName(name: string): string {\n // EC-11 — strip trailing slash + leading `./`\n return basename(name.replace(/\\/$/, ''))\n}\n\n/**\n * Empty a directory, preserving entries in the skip list.\n *\n * Throws if `opts.dir` is not inside `process.cwd()` (EC-3 path safety).\n * Returns `{deleted:0, kept:0}` when the directory does not exist.\n */\nexport async function cleanOutDir(opts: CleanOutDirOptions): Promise<CleanOutDirResult> {\n const resolvedDir = resolvePath(opts.dir)\n const resolvedCwd = resolvePath(process.cwd())\n\n // EC-3 — path safety guard. CRITICAL.\n if (resolvedDir === resolvedCwd) {\n throw new Error(\n `cleanOutDir refused to wipe ${resolvedDir} — must be a child of cwd, not cwd itself`,\n )\n }\n if (!resolvedDir.startsWith(resolvedCwd + sep)) {\n throw new Error(\n `cleanOutDir refused to wipe ${resolvedDir} — must be inside cwd (${resolvedCwd})`,\n )\n }\n\n const skip = new Set((opts.skip ?? DEFAULT_SKIP).map(normalizeSkipName))\n\n let entries: { name: string }[]\n try {\n entries = await fs.readdir(resolvedDir, { withFileTypes: true })\n } catch (err) {\n const code = (err as NodeJS.ErrnoException).code\n if (code === 'ENOENT') return { deleted: 0, kept: 0 }\n throw err\n }\n\n let deleted = 0\n let kept = 0\n for (const entry of entries) {\n const name = entry.name\n if (skip.has(name)) {\n kept++\n continue\n }\n const fullPath = resolvePath(resolvedDir, name)\n try {\n await fs.rm(fullPath, { recursive: true, force: true, maxRetries: 3 })\n deleted++\n } catch (err) {\n const code = (err as NodeJS.ErrnoException).code\n if (code === 'ENOENT') {\n deleted++ // already gone\n continue\n }\n // EC-12 — EROFS or other rm failure: warn + continue, don't crash.\n console.warn(\n `[theokit] cleanOutDir could not remove ${fullPath} (${code ?? 'unknown'}); skipping`,\n )\n kept++\n }\n }\n\n return { deleted, kept }\n}\n\n/**\n * Phase 7 — TOMBSTONE for backward-compat. The SDK v1.1.0's `Agent.registry`\n * handles GC natively; this function is a no-op + emits a deprecation warning\n * ONCE per process (EC-10).\n *\n * Will be deleted entirely in TheoKit 0.4.0. Marked deprecated via runtime\n * warning rather than `@deprecated` JSDoc tag to avoid the eslint\n * sonarjs/deprecation flagging our own internal symbols.\n */\nlet warnedOnce = false\nexport async function gcAgentRegistry(\n _opts: GcAgentRegistryOptions,\n): Promise<GcAgentRegistryResult> {\n if (!warnedOnce) {\n warnedOnce = true\n console.warn(\n '[theokit] gcAgentRegistry is deprecated; SDK Agent.registry handles GC natively (configure via theo.config.ts > agents.registry)',\n )\n }\n return Promise.resolve({ deleted: 0, kept: 0 })\n}\n\n/**\n * @internal — testing helper. Resets the module-scoped warnedOnce flag.\n */\nexport function __resetGcDeprecationWarnedForTests(): void {\n warnedOnce = false\n}\n\n/**\n * Empty the build output directory before `theokit build` writes into it, keeping the agent context\n * and local agent state that share `.theokit/` with the build output. Emptying it whole deleted the\n * scaffold's THEO.md, rules and personalities on the first build (#1079).\n */\nexport async function cleanBuildOutput(distDir: string): Promise<CleanOutDirResult> {\n return cleanOutDir({\n dir: distDir,\n skip: [...DEFAULT_SKIP, ...AUTHORED_AGENT_CONTEXT, ...LOCAL_AGENT_STATE],\n })\n}\n"],"mappings":";;;;AAeA,SAAS,YAAY,UAAU;AAC/B,SAAS,UAAU,WAAW,aAAa,WAAW;AAStD,IAAM,eAAe,CAAC,QAAQ,YAAY,YAAY;AAiB/C,IAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAOA,IAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,SAAS,kBAAkB,MAAsB;AAE/C,SAAO,SAAS,KAAK,QAAQ,OAAO,EAAE,CAAC;AACzC;AAQA,eAAsB,YAAY,MAAsD;AACtF,QAAM,cAAc,YAAY,KAAK,GAAG;AACxC,QAAM,cAAc,YAAY,QAAQ,IAAI,CAAC;AAG7C,MAAI,gBAAgB,aAAa;AAC/B,UAAM,IAAI;AAAA,MACR,+BAA+B,WAAW;AAAA,IAC5C;AAAA,EACF;AACA,MAAI,CAAC,YAAY,WAAW,cAAc,GAAG,GAAG;AAC9C,UAAM,IAAI;AAAA,MACR,+BAA+B,WAAW,+BAA0B,WAAW;AAAA,IACjF;AAAA,EACF;AAEA,QAAM,OAAO,IAAI,KAAK,KAAK,QAAQ,cAAc,IAAI,iBAAiB,CAAC;AAEvE,MAAI;AACJ,MAAI;AACF,cAAU,MAAM,GAAG,QAAQ,aAAa,EAAE,eAAe,KAAK,CAAC;AAAA,EACjE,SAAS,KAAK;AACZ,UAAM,OAAQ,IAA8B;AAC5C,QAAI,SAAS,SAAU,QAAO,EAAE,SAAS,GAAG,MAAM,EAAE;AACpD,UAAM;AAAA,EACR;AAEA,MAAI,UAAU;AACd,MAAI,OAAO;AACX,aAAW,SAAS,SAAS;AAC3B,UAAM,OAAO,MAAM;AACnB,QAAI,KAAK,IAAI,IAAI,GAAG;AAClB;AACA;AAAA,IACF;AACA,UAAM,WAAW,YAAY,aAAa,IAAI;AAC9C,QAAI;AACF,YAAM,GAAG,GAAG,UAAU,EAAE,WAAW,MAAM,OAAO,MAAM,YAAY,EAAE,CAAC;AACrE;AAAA,IACF,SAAS,KAAK;AACZ,YAAM,OAAQ,IAA8B;AAC5C,UAAI,SAAS,UAAU;AACrB;AACA;AAAA,MACF;AAEA,cAAQ;AAAA,QACN,0CAA0C,QAAQ,KAAK,QAAQ,SAAS;AAAA,MAC1E;AACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,KAAK;AACzB;AAoCA,eAAsB,iBAAiB,SAA6C;AAClF,SAAO,YAAY;AAAA,IACjB,KAAK;AAAA,IACL,MAAM,CAAC,GAAG,cAAc,GAAG,wBAAwB,GAAG,iBAAiB;AAAA,EACzE,CAAC;AACH;","names":[]}
@@ -48,6 +48,17 @@ function createOutbox() {
48
48
  }
49
49
 
50
50
  // src/server/jobs/queue-client.ts
51
+ var TransactionalEnqueueUnsupportedError = class extends Error {
52
+ code = "TRANSACTIONAL_ENQUEUE_UNSUPPORTED";
53
+ backend;
54
+ constructor(backend) {
55
+ super(
56
+ `jobs.backend (${backend}) cannot enqueue inside the caller's transaction: it has no enqueueInTransaction method. Use PostgresJobBackend with its table in the database the transaction runs on, or use ctx.queue.enqueue for the after-response outbox.`
57
+ );
58
+ this.name = "TransactionalEnqueueUnsupportedError";
59
+ this.backend = backend;
60
+ }
61
+ };
51
62
  function createQueueClient(backend, outbox, opts = {}) {
52
63
  const traceparent = opts.traceparent;
53
64
  return {
@@ -81,6 +92,18 @@ function createQueueClient(backend, outbox, opts = {}) {
81
92
  };
82
93
  outbox.push(entry);
83
94
  return promise;
95
+ },
96
+ async enqueueInTransaction(client, name, input, enqueueOpts) {
97
+ if (backend.enqueueInTransaction === void 0) {
98
+ throw new TransactionalEnqueueUnsupportedError(backend.name);
99
+ }
100
+ return backend.enqueueInTransaction(client, {
101
+ name,
102
+ input,
103
+ idempotencyKey: enqueueOpts?.idempotencyKey,
104
+ delaySeconds: enqueueOpts?.delaySeconds,
105
+ traceparent
106
+ });
84
107
  }
85
108
  };
86
109
  }
@@ -101,7 +124,8 @@ function createOutboxDispatcher(backend) {
101
124
  export {
102
125
  DuplicateContextKeyError,
103
126
  createOutbox,
127
+ TransactionalEnqueueUnsupportedError,
104
128
  createQueueClient,
105
129
  createOutboxDispatcher
106
130
  };
107
- //# sourceMappingURL=chunk-47FFT43U.js.map
131
+ //# sourceMappingURL=chunk-YH5CDWLU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/server/jobs/duplicate-context-key-error.ts","../src/server/jobs/outbox.ts","../src/server/jobs/queue-client.ts"],"mappings":";AAQO,IAAM,2BAAN,cAAuC,MAAM;AAAA,EAElD,YACkB,KAChB,MACA;AACA;AAAA,MACE,0BAA0B,GAAG,MAAM,MAAM,UAAU,4FAA4F;AAAA,IACjJ;AALgB;AAMhB,SAAK,OAAO;AAAA,EACd;AAAA,EAPkB;AAAA,EAFT,OAAO;AAUlB;;;ACmCO,SAAS,eAAuB;AACrC,MAAI,SAA4B,CAAC;AAEjC,SAAO;AAAA,IACL,KAAK,OAAO;AACV,aAAO,KAAK,KAAK;AAAA,IACnB;AAAA,IACA,QAAQ;AACN,YAAM,MAAM;AACZ,eAAS,CAAC;AACV,aAAO;AAAA,IACT;AAAA,IACA,UAAU;AACR,eAAS,CAAC;AAAA,IACZ;AAAA,IACA,OAAO;AACL,aAAO,OAAO;AAAA,IAChB;AAAA,IACA,MAAM,MAAM,YAAY,MAAM;AAC5B,YAAM,UAAU;AAChB,eAAS,CAAC;AACV,YAAM,UACJ,MAAM,YACL,CAAC,MAAM,QAAQ;AACd,gBAAQ,KAAK,0CAA0C,IAAI,MAAM,GAAG,EAAE;AAAA,MACxE;AACF,iBAAW,KAAK,SAAS;AACvB,YAAI;AACF,gBAAM,WAAW,CAAC;AAAA,QACpB,SAAS,KAAK;AACZ,gBAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC/D,kBAAQ,EAAE,MAAM,OAAO;AAAA,QACzB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;;;ACzBO,IAAM,uCAAN,cAAmD,MAAM;AAAA,EACrD,OAAO;AAAA,EACP;AAAA,EACT,YAAY,SAAiB;AAC3B;AAAA,MACE,iBAAiB,OAAO;AAAA,IAG1B;AACA,SAAK,OAAO;AACZ,SAAK,UAAU;AAAA,EACjB;AACF;AAcO,SAAS,kBACd,SACA,QACA,OAAiC,CAAC,GACrB;AACb,QAAM,cAAc,KAAK;AAEzB,SAAO;AAAA,IACL,QAAQ,MAAM,OAAO,aAAa;AAChC,YAAM,QAAyB;AAAA,QAC7B;AAAA,QACA;AAAA,QACA,gBAAgB,aAAa;AAAA,QAC7B,cAAc,aAAa;AAAA,QAC3B;AAAA,MACF;AACA,aAAO,KAAK,KAAK;AAAA,IACnB;AAAA,IAEA,cAAc,MAAM,OAAO,aAAa;AACtC,UAAI;AACJ,UAAI;AACJ,YAAM,UAAU,IAAI,QAA2B,CAAC,SAAS,WAAW;AAClE,uBAAe;AACf,sBAAc;AAAA,MAChB,CAAC;AAED,WAAK,QAAQ,MAAM,MAAM;AAAA,MAEzB,CAAC;AAGD,YAAM,QAGF;AAAA,QACF;AAAA,QACA;AAAA,QACA,gBAAgB,aAAa;AAAA,QAC7B,cAAc,aAAa;AAAA,QAC3B;AAAA,QACA,gBAAgB;AAAA,QAChB,eAAe;AAAA,MACjB;AACA,aAAO,KAAK,KAAK;AACjB,aAAO;AAAA,IACT;AAAA,IAEA,MAAM,qBAAqB,QAAQ,MAAM,OAAO,aAAa;AAC3D,UAAI,QAAQ,yBAAyB,QAAW;AAC9C,cAAM,IAAI,qCAAqC,QAAQ,IAAI;AAAA,MAC7D;AACA,aAAO,QAAQ,qBAAqB,QAAQ;AAAA,QAC1C;AAAA,QACA;AAAA,QACA,gBAAgB,aAAa;AAAA,QAC7B,cAAc,aAAa;AAAA,QAC3B;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAQO,SAAS,uBACd,SAC8C;AAC9C,SAAO,OAAO,UAAU;AACtB,UAAM,YAAY;AAIlB,QAAI;AACF,YAAM,SAAS,MAAM,QAAQ,QAAQ,KAAK;AAC1C,gBAAU,iBAAiB,MAAM;AACjC,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,gBAAU,gBAAgB,GAAG;AAC7B,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}
package/dist/cli/index.js CHANGED
@@ -15,7 +15,7 @@ function cliVersion() {
15
15
  // src/cli/index.ts
16
16
  var cli = cac("theokit");
17
17
  cli.command("dev", "Start development server").option("--port <port>", "Port number").option("--crons", "Schedule the crons in dev too (off by default)").action(async (options) => {
18
- const { devCommand } = await import("../dev-R2ZYHZV4.js");
18
+ const { devCommand } = await import("../dev-N5LQFLBR.js");
19
19
  await devCommand({
20
20
  port: options.port ? Number(options.port) : void 0,
21
21
  crons: options.crons === true
@@ -23,7 +23,7 @@ cli.command("dev", "Start development server").option("--port <port>", "Port num
23
23
  });
24
24
  cli.command("build", "Build for production").option("--target <target>", "Deploy target (node, vercel, cloudflare)").action(async (options) => {
25
25
  try {
26
- const { buildCommand } = await import("../build-Y3CWTWP6.js");
26
+ const { buildCommand } = await import("../build-Y457R5HE.js");
27
27
  await buildCommand({ target: options.target });
28
28
  } catch (err) {
29
29
  const msg = err instanceof Error ? err.message : String(err);
@@ -35,7 +35,7 @@ cli.command("build", "Build for production").option("--target <target>", "Deploy
35
35
  });
36
36
  cli.command("start", "Start production server").option("--port <port>", "Port number").action(async (options) => {
37
37
  try {
38
- const { startCommand } = await import("../start-LNT5UVSY.js");
38
+ const { startCommand } = await import("../start-EJFYT7ZU.js");
39
39
  await startCommand({ port: options.port ? Number(options.port) : void 0 });
40
40
  } catch (err) {
41
41
  const msg = err instanceof Error ? err.message : String(err);
@@ -47,7 +47,7 @@ cli.command("start", "Start production server").option("--port <port>", "Port nu
47
47
  });
48
48
  cli.command("preview", "Build for production, then serve it \u2014 one step (B-030)").option("--port <port>", "Port number").option("--target <target>", "Deploy target (node, vercel, cloudflare)").action(async (options) => {
49
49
  try {
50
- const { previewCommand } = await import("../preview-DLIVPM7A.js");
50
+ const { previewCommand } = await import("../preview-Y3JNYOFK.js");
51
51
  await previewCommand({
52
52
  port: options.port ? Number(options.port) : void 0,
53
53
  target: options.target
@@ -65,7 +65,7 @@ cli.command(
65
65
  "Scaffold a route, action, page, ws, controller, agent, toolbox, workflow, eval, sandbox, schedule, memory, or resource (resource accepts field:type args)"
66
66
  ).action(async (type, name, fields) => {
67
67
  try {
68
- const { generateCommand } = await import("../generate-6F24XT72.js");
68
+ const { generateCommand } = await import("../generate-4DY3MEYB.js");
69
69
  await generateCommand(type, name, fields.length > 0 ? fields : void 0);
70
70
  } catch (err) {
71
71
  const msg = err instanceof Error ? err.message : String(err);
@@ -80,7 +80,7 @@ cli.command(
80
80
  "Run an agent in the terminal (stream + tool calls + approval)"
81
81
  ).action(async (name, message) => {
82
82
  try {
83
- const { agentCommand } = await import("../agent-HCK5RHH7.js");
83
+ const { agentCommand } = await import("../agent-MJWQRSJ2.js");
84
84
  const { sawError } = await agentCommand(name, message);
85
85
  if (sawError) process.exit(1);
86
86
  } catch (err) {
@@ -111,7 +111,7 @@ cli.command("agent sessions gc", "Collect old transcripts for this project (dry
111
111
  });
112
112
  cli.command("mcp <agent>", "Serve an agent as an MCP server over stdio (for desktop MCP clients)").action(async (agent) => {
113
113
  try {
114
- const { mcpCommand } = await import("../mcp-FBXEX45H.js");
114
+ const { mcpCommand } = await import("../mcp-3ENI2IPS.js");
115
115
  await mcpCommand(agent);
116
116
  } catch (err) {
117
117
  const msg = err instanceof Error ? err.message : String(err);
@@ -123,7 +123,7 @@ cli.command("mcp <agent>", "Serve an agent as an MCP server over stdio (for desk
123
123
  });
124
124
  cli.command("routes", "List all routes, actions, and WebSocket endpoints").action(async () => {
125
125
  try {
126
- const { routesCommand } = await import("../routes-BJ7GGRCV.js");
126
+ const { routesCommand } = await import("../routes-UNJ77IQU.js");
127
127
  await routesCommand();
128
128
  } catch (err) {
129
129
  const msg = err instanceof Error ? err.message : String(err);
@@ -160,11 +160,11 @@ cli.command("check", "Run typecheck + scan + (optional) eslint").option(
160
160
  await checkCommand();
161
161
  });
162
162
  cli.command("add <package>", "Install a known TheoKit adapter or plugin (whitelist-only)").action(async (pkg) => {
163
- const { addCommand } = await import("../add-DOR7HORT.js");
163
+ const { addCommand } = await import("../add-NFDL4OJ7.js");
164
164
  await addCommand(pkg);
165
165
  });
166
166
  cli.command("info", "Print environment info (runtime, config, routes)").action(async () => {
167
- const { infoCommand } = await import("../info-IPMW56PI.js");
167
+ const { infoCommand } = await import("../info-ELSPSCXK.js");
168
168
  await infoCommand();
169
169
  });
170
170
  cli.command("doctor", "Report the RESOLVED state of this installation (never prints a secret)").action(async () => {
@@ -176,7 +176,7 @@ cli.command(
176
176
  "Generate <distDir>/openapi.json from route schemas (opt-in via config.openapi)"
177
177
  ).option("--dry-run", "Print the document to stdout without writing to disk (EC-3)").action(async (options) => {
178
178
  try {
179
- const { openapiCommand } = await import("../openapi-CA3E3LZH.js");
179
+ const { openapiCommand } = await import("../openapi-OVXYHZ2S.js");
180
180
  await openapiCommand({ dryRun: Boolean(options.dryRun) });
181
181
  } catch (err) {
182
182
  const msg = err instanceof Error ? err.message : String(err);
@@ -223,7 +223,7 @@ cli.command(
223
223
  });
224
224
  cli.command("docker", "Generate Dockerfile for production").option("--force", "Overwrite existing Dockerfile").action(async (options) => {
225
225
  try {
226
- const { dockerCommand } = await import("../docker-LZZB4D5E.js");
226
+ const { dockerCommand } = await import("../docker-OTV3M54A.js");
227
227
  await dockerCommand({ force: options.force });
228
228
  } catch (err) {
229
229
  const msg = err instanceof Error ? err.message : String(err);
@@ -238,7 +238,7 @@ cli.command(
238
238
  "Database commands: generate (write SQL migration files), migrate (apply them), push (diff the schema into the database, no files), seed"
239
239
  ).action(async (action) => {
240
240
  try {
241
- const { dbCommandCli } = await import("../db-ZWDKD57T.js");
241
+ const { dbCommandCli } = await import("../db-5WOK6HA2.js");
242
242
  await dbCommandCli(action);
243
243
  } catch (err) {
244
244
  const msg = err instanceof Error ? err.message : String(err);
@@ -2,10 +2,10 @@
2
2
  import "tsx/esm";
3
3
  import {
4
4
  loadConfig
5
- } from "./chunk-W2I6L4IJ.js";
5
+ } from "./chunk-35OI2TKT.js";
6
6
  import "./chunk-3QPVEJ7D.js";
7
7
  import "./chunk-O5JZ6ROY.js";
8
- import "./chunk-C2BRSL4W.js";
8
+ import "./chunk-PQWVT6JC.js";
9
9
  import "./chunk-L4V5V2TI.js";
10
10
  import "./chunk-MAJZ2L3A.js";
11
11
 
@@ -83,4 +83,4 @@ export {
83
83
  dbCommand,
84
84
  dbCommandCli
85
85
  };
86
- //# sourceMappingURL=db-ZWDKD57T.js.map
86
+ //# sourceMappingURL=db-5WOK6HA2.js.map
@@ -1,6 +1,31 @@
1
1
  import { z } from 'zod';
2
2
  import { R as RoutePolicy } from './route-policy-BHXQDzBF.js';
3
3
 
4
+ /**
5
+ * The `ctx` a `route()` handler receives, open to declaration merging.
6
+ *
7
+ * At runtime `ctx` holds what `server/context.ts` returns, what plugins decorate and, when
8
+ * `theo.config.ts` sets `jobs.backend`, `ctx.queue`. The framework cannot see the config from a
9
+ * route file, so it types none of those keys: each is `unknown` until the app declares it, which is
10
+ * the stance of `ctx-reconciliation.ts` (a key typed as present on a route where it is absent is the
11
+ * lie that contract rules out). Before this interface the whole `ctx` was `unknown`, so even
12
+ * `ctx.queue` needed a cast (usetheokit/theokit#1073).
13
+ *
14
+ * An app declares what its config provides, once, in a `.d.ts` file. The scaffold's
15
+ * `types/jobs.d.ts` carries this block, commented out, for apps that set `jobs.backend`:
16
+ *
17
+ * ```ts
18
+ * declare module 'theokit/server/define' {
19
+ * interface RouteContext {
20
+ * queue: import('theokit/server/jobs').QueueClient
21
+ * }
22
+ * }
23
+ * ```
24
+ */
25
+ interface RouteContext {
26
+ [key: string]: unknown;
27
+ }
28
+
4
29
  /**
5
30
  * core/contracts/route-config.ts
6
31
  *
@@ -16,7 +41,7 @@ import { R as RoutePolicy } from './route-policy-BHXQDzBF.js';
16
41
  * `tests/unit/route-config-generic-arity.test.ts`.
17
42
  */
18
43
 
19
- interface RouteConfig<TQuery extends z.ZodType = z.ZodUndefined, TBody extends z.ZodType = z.ZodUndefined, TParams extends z.ZodType = z.ZodUndefined, TCtx = unknown, TResponse = unknown> {
44
+ interface RouteConfig<TQuery extends z.ZodType = z.ZodUndefined, TBody extends z.ZodType = z.ZodUndefined, TParams extends z.ZodType = z.ZodUndefined, TCtx = RouteContext, TResponse = unknown> {
20
45
  query?: TQuery;
21
46
  body?: TBody;
22
47
  params?: TParams;
@@ -107,4 +132,4 @@ interface RouteConfig<TQuery extends z.ZodType = z.ZodUndefined, TBody extends z
107
132
  type MiddlewareNext = () => Promise<Response | undefined>;
108
133
  type MiddlewareHandler = (request: Request, context: Record<string, unknown>, next: MiddlewareNext) => Response | undefined | void | Promise<Response | undefined | void>;
109
134
 
110
- export type { MiddlewareHandler as M, RouteConfig as R, MiddlewareNext as a };
135
+ export type { MiddlewareHandler as M, RouteConfig as R, RouteContext as a, MiddlewareNext as b };
@@ -16,19 +16,20 @@ import {
16
16
  initCacheEngineFromConfig,
17
17
  loadCronModules,
18
18
  loadJobModules,
19
+ prepareJobBackend,
19
20
  startJobWorker
20
- } from "./chunk-OED37LE5.js";
21
+ } from "./chunk-GNV34JMI.js";
21
22
  import {
22
23
  preflightNodeAndBindings
23
24
  } from "./chunk-KTMQUYED.js";
24
25
  import {
25
26
  theoPluginAsync
26
- } from "./chunk-2SGNODVJ.js";
27
- import "./chunk-ZQJORKBM.js";
27
+ } from "./chunk-HNALEGOL.js";
28
+ import "./chunk-HZAXFD55.js";
28
29
  import "./chunk-BDH5GKFZ.js";
29
30
  import "./chunk-3PWQQWT6.js";
30
31
  import "./chunk-FDOOBTXJ.js";
31
- import "./chunk-XI4FALFZ.js";
32
+ import "./chunk-E22GPCCO.js";
32
33
  import "./chunk-4JRXZTVQ.js";
33
34
  import "./chunk-FNJVSFEC.js";
34
35
  import "./chunk-WSMLSIS5.js";
@@ -42,12 +43,12 @@ import "./chunk-4WP7A7RX.js";
42
43
  import "./chunk-Z7CJHDLS.js";
43
44
  import {
44
45
  loadConfig
45
- } from "./chunk-W2I6L4IJ.js";
46
+ } from "./chunk-35OI2TKT.js";
46
47
  import {
47
48
  loadEnv
48
49
  } from "./chunk-3QPVEJ7D.js";
49
50
  import "./chunk-O5JZ6ROY.js";
50
- import "./chunk-C2BRSL4W.js";
51
+ import "./chunk-PQWVT6JC.js";
51
52
  import {
52
53
  orchestrateDev
53
54
  } from "./chunk-L4V5V2TI.js";
@@ -79,6 +80,7 @@ async function startDevServer(cwd, options) {
79
80
  validateProjectStructure(cwd, config.appDir);
80
81
  await initCacheEngineFromConfig(config.cache);
81
82
  await configureStorageManagerFromConfig(config.storage);
83
+ await prepareJobBackend(config);
82
84
  const orchestration = await orchestrateDev({
83
85
  cwd,
84
86
  services: config.services
@@ -177,4 +179,4 @@ export {
177
179
  devCommand,
178
180
  startDevServer
179
181
  };
180
- //# sourceMappingURL=dev-R2ZYHZV4.js.map
182
+ //# sourceMappingURL=dev-N5LQFLBR.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/commands/dev.ts"],"sourcesContent":["import { resolve } from 'node:path'\n\nimport react from '@vitejs/plugin-react'\nimport { createServer, type Plugin, type ServerOptions, type ViteDevServer } from 'vite'\n\nimport { loadConfig } from '../../config/load-config.js'\nimport { loadEnv } from '../../config/load-env.js'\nimport type { TheoConfig } from '../../config/schema.js'\nimport { validateProjectStructure } from '../../config/validate-structure.js'\nimport { initCacheEngineFromConfig } from '../../server/cache-bootstrap.js'\nimport { createCronScheduler } from '../../server/cron/cron-runtime-node.js'\nimport { cronScanDirs, listCronFiles } from '../../server/cron/cron-scan.js'\nimport { listJobFiles } from '../../server/jobs/job-scan.js'\nimport { orchestrateDev } from '../../services/index.js'\nimport { theoPluginAsync } from '../../vite-plugin/index.js'\nimport { preflightNodeAndBindings } from '../preflight-node-version.js'\n\nimport { configureStorageManagerFromConfig } from './start/bootstrap-stages.js'\nimport { loadCronModules } from './start/cron-bootstrap.js'\nimport { loadJobModules, prepareJobBackend, startJobWorker } from './start/job-bootstrap.js'\n\ninterface DevOptions {\n port?: number\n /** Schedule the crons in dev (`theokit dev --crons`). Off by default (usetheokit/theokit#1017). */\n crons?: boolean\n}\n\n/**\n * The Vite `server` block, as a pure function of the loaded config — the same reasoning\n * `buildSecurityHeaders` is written down with: a setting that reaches Vite only from inside a\n * booted dev server can be asserted only by booting one, and a setting nobody can assert is how a\n * config field ends up existing and doing nothing (#555).\n *\n * Every key here is omitted rather than set to `undefined` when the app said nothing, so Vite's own\n * defaults apply. That matters most for `allowedHosts`, where the falsy value is `[]` — an empty\n * allowlist blocks every host, loopback included, so writing one on silence would turn \"no opinion\"\n * into \"refuse everything\".\n */\nexport function buildDevServerOptions(config: TheoConfig, port: number): ServerOptions {\n return {\n port,\n host: config.host,\n open: config.open,\n strictPort: config.strictPort,\n ...(config.allowedHosts !== undefined ? { allowedHosts: config.allowedHosts } : {}),\n warmup: config.warmup ?? {\n clientFiles: ['./app/**/*.tsx', './app/**/*.ts'],\n },\n }\n}\n\nexport async function startDevServer(cwd: string, options?: DevOptions): Promise<ViteDevServer> {\n // Preflight (FIRST — BEFORE anything that touches native bindings):\n // verifies Node version + native binding ABI match. Emits actionable\n // error referencing `nvm use` + `pnpm rebuild` when the dev server\n // was spawned under the wrong Node (common gotcha with `nohup env ...`\n // stripping the nvm PATH prefix).\n preflightNodeAndBindings(cwd)\n\n // Phase 1 (T1.2) — Load .env files into process.env BEFORE any module\n // reads them. Must run before loadConfig() so theo.config.ts functions\n // referencing process.env.* resolve correctly.\n loadEnv({ cwd, mode: 'development' })\n\n const config = await loadConfig(cwd)\n // #95 — pass config.appDir so the structure gate honors a custom frontend dir (e.g. apps/web).\n validateProjectStructure(cwd, config.appDir)\n\n // #352 — same engine, same config key, so `revalidateTag` behaves identically\n // under `theo dev` and `theo start`. A cache that only exists in production is\n // a cache nobody develops against.\n await initCacheEngineFromConfig(config.cache)\n\n // #1020 — the storage counterpart. `start` applied `config.storage` and `dev` did not, so every\n // `usePostgres(...)` threw \"Database not configured\" in development.\n await configureStorageManagerFromConfig(config.storage)\n\n // #1072 — create the job table before Vite serves a route that enqueues into it. A failure stops\n // the boot here, before any service or port is taken.\n await prepareJobBackend(config)\n\n // Wave 2 (T1.1) — spawn polyglot services BEFORE Vite. Healthcheck gates\n // readiness. Empty `services: {}` → early return (Wave 1 BC preserved).\n const orchestration = await orchestrateDev({\n cwd,\n services: config.services,\n })\n if (!orchestration.allHealthy) {\n await orchestration.stop()\n throw new Error(\n `[services] services failed healthcheck: ${orchestration.unhealthy.join(', ')}. ` +\n `Check that each declared service binds its port and responds 200 on its ` +\n `healthcheck path within 30s.`,\n )\n }\n\n // Phase 7 — legacy fs-mtime sweep removed: SDK's Agent.registry handles\n // LRU + idle eviction natively (configurable via theo.config.ts >\n // agents.registry; lazy-configured on first request).\n\n const port = options?.port ?? config.port\n // Narrow the rateLimit union: only the legacy flat shape (windowMs+max)\n // flows into the theoPlugin's RateLimitConfig parameter. The per-route\n // variant is consumed inside the api-middleware via the loaded user\n // config separately.\n const flatRateLimit =\n config.rateLimit && 'windowMs' in config.rateLimit && 'max' in config.rateLimit\n ? config.rateLimit\n : undefined\n // theoPluginAsync auto-chains @theokit/ui + @tailwindcss/vite via\n // top-level Plugin[] return (sync `theoPlugin()` factory's config()\n // hook returning {plugins:[...]} is silently dropped by Vite — see\n // commit history). Spread the result so Vite flattens them.\n let server: ViteDevServer\n try {\n const theoPlugins = await theoPluginAsync({\n root: cwd,\n rateLimit: flatRateLimit,\n ssr: config.ssr,\n // #95 — honor config `serverDir` (default \"server\") so route/action discovery scans it.\n serverDir: config.serverDir,\n // #95 follow-up — honor config `agentsDir` (default \"agents\") for the agent scan/middleware.\n agentsDir: config.agentsDir,\n // #95 follow-up — honor config `appDir` (default \"app\") for the file-based router + SSR/client entry.\n appDir: config.appDir,\n // Wave 2 (T3.1) — wire typed-client plugin when services declared.\n services: config.services,\n // T4.1 (canvas-ecosystem-refactor / ADR D6) — passthrough peer-deps\n // that plugins import dynamically (e.g., mermaid via plugin-canvas).\n viteOptimizeDeps: config.viteOptimizeDeps,\n })\n server = await createServer({\n root: cwd,\n plugins: [react(), ...theoPlugins] as Plugin[],\n server: buildDevServerOptions(config, port),\n logLevel: options?.port === 0 ? 'silent' : undefined,\n })\n\n await server.listen()\n } catch (err) {\n // EC-1 / try-finally pattern: if Vite create/listen fails AFTER services\n // started, stop them so we don't leak child processes.\n await orchestration.stop()\n throw err\n }\n\n // EC-1 fix: attach orchestration.stop() to the underlying HTTP server's\n // close event via Node-native API. We do NOT mutate `server.close`\n // (fragile across Vite upgrades). httpServer is `http.Server | null`.\n server.httpServer?.on('close', () => {\n void orchestration.stop()\n })\n\n await startDevJobWorker(server, cwd, config)\n await startDevCrons(server, cwd, config, options?.crons === true)\n\n return server\n}\n\n/**\n * The job worker `theokit start` runs, in development too (usetheokit/theokit#1010): `ctx.queue`\n * works in dev since #1009, and a queue nothing drains would make every job untestable without a\n * production build. Job files load through Vite, like routes, and the worker stops with the server.\n */\nasync function startDevJobWorker(\n server: ViteDevServer,\n cwd: string,\n config: TheoConfig,\n): Promise<void> {\n const files = listJobFiles(resolve(cwd, config.serverDir, 'jobs'))\n const definitions = await loadJobModules(files, (filePath) => server.ssrLoadModule(filePath))\n const jobs = startJobWorker(config, definitions)\n if (jobs.summary !== undefined) console.log(`\\n ${jobs.summary}`)\n server.httpServer?.on('close', () => {\n void jobs.worker?.stop()\n })\n}\n\n/**\n * Crons in development (usetheokit/theokit#1017). `dev` had no cron code path and said nothing, so\n * a new cron neither fired nor got explained until `build` plus `start`. Scheduling is opt-in\n * (`--crons`): a cron that sends an email or charges a card should not do it on every dev boot\n * unasked. Either way the boot log says what happens to the declared crons. Files load through\n * Vite once at boot, so an edit to a cron applies after a restart. Single process, so no lock.\n */\nasync function startDevCrons(\n server: ViteDevServer,\n cwd: string,\n config: TheoConfig,\n schedule: boolean,\n): Promise<void> {\n const dirs = cronScanDirs(cwd, config.serverDir, config.agentsDir)\n const files = listCronFiles([dirs.crons, dirs.schedules])\n if (files.length === 0) return\n if (!schedule) {\n console.log(\n `\\n Crons: ${String(files.length)} declared, not scheduled in dev. ` +\n 'Run `theokit dev --crons` to schedule them (edits apply after a restart).',\n )\n return\n }\n const definitions = await loadCronModules(files, (filePath) => server.ssrLoadModule(filePath))\n const scheduler = createCronScheduler(definitions)\n scheduler.start()\n console.log(\n `\\n Crons: ${String(definitions.length)} scheduled in dev (--crons); edits apply after a restart.`,\n )\n server.httpServer?.on('close', () => {\n scheduler.stop()\n })\n}\n\nexport async function devCommand(options: DevOptions): Promise<void> {\n try {\n const cwd = process.cwd()\n const server = await startDevServer(cwd, options)\n server.printUrls()\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err)\n console.error(`\\n ✗ ${msg}\\n`)\n process.exit(1)\n }\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,130 @@
1
+ #!/usr/bin/env node
2
+ import "tsx/esm";
3
+ import {
4
+ AUTHORED_AGENT_CONTEXT
5
+ } from "./chunk-V3LMUQSB.js";
6
+ import {
7
+ loadConfig
8
+ } from "./chunk-35OI2TKT.js";
9
+ import "./chunk-3QPVEJ7D.js";
10
+ import "./chunk-O5JZ6ROY.js";
11
+ import "./chunk-PQWVT6JC.js";
12
+ import "./chunk-L4V5V2TI.js";
13
+ import "./chunk-MAJZ2L3A.js";
14
+
15
+ // src/cli/commands/docker.ts
16
+ import { existsSync, writeFileSync } from "fs";
17
+ import { resolve } from "path";
18
+ function detectPkgManager(cwd) {
19
+ if (existsSync(resolve(cwd, "pnpm-lock.yaml"))) return "pnpm";
20
+ if (existsSync(resolve(cwd, "yarn.lock"))) return "yarn";
21
+ return "npm";
22
+ }
23
+ var THEOKIT_BIN = "./node_modules/.bin/theokit";
24
+ function topLevelDir(path) {
25
+ return path.replace(/^\.\//, "").split("/")[0];
26
+ }
27
+ function generateDockerfile(input) {
28
+ const { pkgManager, distDir } = input;
29
+ const installCmd = {
30
+ pnpm: "RUN corepack enable && pnpm install --frozen-lockfile",
31
+ npm: "RUN npm ci",
32
+ yarn: "RUN yarn install --frozen-lockfile"
33
+ }[pkgManager];
34
+ const lockfile = {
35
+ pnpm: "pnpm-lock.yaml",
36
+ npm: "package-lock.json",
37
+ yarn: "yarn.lock"
38
+ }[pkgManager];
39
+ const manifests = [
40
+ "package.json",
41
+ lockfile,
42
+ ...pkgManager === "pnpm" && input.hasPnpmWorkspace ? ["pnpm-workspace.yaml"] : []
43
+ ];
44
+ const copySources = [...new Set(input.sourceRoots)].map(
45
+ (root) => `COPY --from=builder /app/${root} ./${root}`
46
+ );
47
+ return [
48
+ "# Generated by TheoKit",
49
+ "# Multi-stage build for production",
50
+ "",
51
+ "# Stage 1: Build",
52
+ "FROM node:22-alpine AS builder",
53
+ "WORKDIR /app",
54
+ `COPY ${manifests.join(" ")} ./`,
55
+ installCmd,
56
+ "COPY . .",
57
+ `RUN ${THEOKIT_BIN} build`,
58
+ "",
59
+ "# Stage 2: Production",
60
+ "FROM node:22-alpine AS runner",
61
+ "WORKDIR /app",
62
+ "ENV NODE_ENV=production",
63
+ // Inside a container `localhost` answers nobody, the image's own health check included (#402).
64
+ "ENV HOST=0.0.0.0",
65
+ "ENV PORT=3000",
66
+ `COPY --from=builder /app/${distDir} ./${distDir}`,
67
+ ...copySources,
68
+ ...input.hasConfigFile ? ["COPY --from=builder /app/theo.config.ts ./theo.config.ts"] : [],
69
+ ...manifests.map((file) => `COPY --from=builder /app/${file} ./${file}`),
70
+ "COPY --from=builder /app/node_modules ./node_modules",
71
+ "",
72
+ "EXPOSE 3000",
73
+ `CMD ["${THEOKIT_BIN}", "start"]`,
74
+ ""
75
+ ].join("\n");
76
+ }
77
+ function generateDockerignore(distDir = ".theokit") {
78
+ return [
79
+ "node_modules",
80
+ ".git",
81
+ `${distDir}/*`,
82
+ // A re-included directory brings its contents: Docker matches a pattern against every parent.
83
+ ...AUTHORED_AGENT_CONTEXT.map((entry) => `!${distDir}/${entry}`),
84
+ "dist",
85
+ ".env",
86
+ ".env.*",
87
+ "!.env.example",
88
+ "*.log",
89
+ ".DS_Store",
90
+ ".vscode",
91
+ ".idea",
92
+ "Dockerfile",
93
+ ".dockerignore",
94
+ ""
95
+ ].join("\n");
96
+ }
97
+ async function dockerCommand(options) {
98
+ const cwd = process.cwd();
99
+ const dockerfilePath = resolve(cwd, "Dockerfile");
100
+ const dockerignorePath = resolve(cwd, ".dockerignore");
101
+ const pkgManager = detectPkgManager(cwd);
102
+ const { serverDir, agentsDir, distDir } = await loadConfig(cwd);
103
+ const dockerfile = generateDockerfile({
104
+ pkgManager,
105
+ sourceRoots: [topLevelDir(serverDir), topLevelDir(agentsDir)],
106
+ distDir,
107
+ hasConfigFile: existsSync(resolve(cwd, "theo.config.ts")),
108
+ hasPnpmWorkspace: existsSync(resolve(cwd, "pnpm-workspace.yaml"))
109
+ });
110
+ try {
111
+ writeFileSync(dockerfilePath, dockerfile, { flag: options?.force ? "w" : "wx" });
112
+ } catch (err) {
113
+ if (err.code !== "EEXIST") throw err;
114
+ console.log("\n \u26A0 Dockerfile already exists. Use --force to overwrite.\n");
115
+ return;
116
+ }
117
+ writeFileSync(dockerignorePath, generateDockerignore(distDir));
118
+ console.log(`
119
+ \u2713 Generated Dockerfile (${pkgManager})`);
120
+ console.log(` \u2713 Generated .dockerignore`);
121
+ console.log(`
122
+ Next steps:`);
123
+ console.log(` docker build -t my-app .`);
124
+ console.log(` docker run -p 3000:3000 my-app
125
+ `);
126
+ }
127
+ export {
128
+ dockerCommand
129
+ };
130
+ //# sourceMappingURL=docker-OTV3M54A.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/cli/commands/docker.ts"],"sourcesContent":["import { existsSync, writeFileSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nimport { loadConfig } from '../../config/load-config.js'\nimport { AUTHORED_AGENT_CONTEXT } from '../cleanup/cleanup.js'\n\nfunction detectPkgManager(cwd: string): PkgManager {\n if (existsSync(resolve(cwd, 'pnpm-lock.yaml'))) return 'pnpm'\n if (existsSync(resolve(cwd, 'yarn.lock'))) return 'yarn'\n return 'npm'\n}\n\ntype PkgManager = 'pnpm' | 'npm' | 'yarn'\n\ninterface DockerfileInput {\n readonly pkgManager: PkgManager\n /** Top-level directories holding the server and agent sources, e.g. `['src']` for the scaffold. */\n readonly sourceRoots: readonly string[]\n /** The configured build output directory, `.theokit` by default. */\n readonly distDir: string\n readonly hasConfigFile: boolean\n readonly hasPnpmWorkspace: boolean\n}\n\n/**\n * The installed CLI, by path. `npx theo build` asked the registry for a package named `theo`, an\n * unrelated design-tokens tool, then installed and ran it inside the image build (#1069). A path\n * into `node_modules/.bin` cannot fall back to the registry under any package manager.\n */\nconst THEOKIT_BIN = './node_modules/.bin/theokit'\n\n/**\n * The top-level directory a configured path lives in. The runner copies whole roots: the scaffold's\n * `src/server` imports `src/shared`, so copying only `serverDir` would leave an import dangling.\n */\nfunction topLevelDir(path: string): string {\n return path.replace(/^\\.\\//, '').split('/')[0]\n}\n\nfunction generateDockerfile(input: DockerfileInput): string {\n const { pkgManager, distDir } = input\n const installCmd = {\n pnpm: 'RUN corepack enable && pnpm install --frozen-lockfile',\n npm: 'RUN npm ci',\n yarn: 'RUN yarn install --frozen-lockfile',\n }[pkgManager]\n\n const lockfile = {\n pnpm: 'pnpm-lock.yaml',\n npm: 'package-lock.json',\n yarn: 'yarn.lock',\n }[pkgManager]\n\n // pnpm 10 reads `allowBuilds` from pnpm-workspace.yaml; installing without it leaves esbuild unbuilt.\n const manifests = [\n 'package.json',\n lockfile,\n ...(pkgManager === 'pnpm' && input.hasPnpmWorkspace ? ['pnpm-workspace.yaml'] : []),\n ]\n\n const copySources = [...new Set(input.sourceRoots)].map(\n (root) => `COPY --from=builder /app/${root} ./${root}`,\n )\n\n return [\n '# Generated by TheoKit',\n '# Multi-stage build for production',\n '',\n '# Stage 1: Build',\n 'FROM node:22-alpine AS builder',\n 'WORKDIR /app',\n `COPY ${manifests.join(' ')} ./`,\n installCmd,\n 'COPY . .',\n `RUN ${THEOKIT_BIN} build`,\n '',\n '# Stage 2: Production',\n 'FROM node:22-alpine AS runner',\n 'WORKDIR /app',\n 'ENV NODE_ENV=production',\n // Inside a container `localhost` answers nobody, the image's own health check included (#402).\n 'ENV HOST=0.0.0.0',\n 'ENV PORT=3000',\n `COPY --from=builder /app/${distDir} ./${distDir}`,\n ...copySources,\n ...(input.hasConfigFile ? ['COPY --from=builder /app/theo.config.ts ./theo.config.ts'] : []),\n ...manifests.map((file) => `COPY --from=builder /app/${file} ./${file}`),\n 'COPY --from=builder /app/node_modules ./node_modules',\n '',\n 'EXPOSE 3000',\n `CMD [\"${THEOKIT_BIN}\", \"start\"]`,\n '',\n ].join('\\n')\n}\n\n/**\n * `.theokit` is both the build output and the agent context (#1079). The context a person writes\n * (THEO.md, rules, personalities ...) goes into the image; local agent state such as memory and MCP\n * tokens stays out, and so does a stale local build, which the image rebuilds anyway.\n */\nfunction generateDockerignore(distDir = '.theokit'): string {\n return [\n 'node_modules',\n '.git',\n `${distDir}/*`,\n // A re-included directory brings its contents: Docker matches a pattern against every parent.\n ...AUTHORED_AGENT_CONTEXT.map((entry) => `!${distDir}/${entry}`),\n 'dist',\n '.env',\n '.env.*',\n '!.env.example',\n '*.log',\n '.DS_Store',\n '.vscode',\n '.idea',\n 'Dockerfile',\n '.dockerignore',\n '',\n ].join('\\n')\n}\n\nexport async function dockerCommand(options?: { force?: boolean }): Promise<void> {\n const cwd = process.cwd()\n const dockerfilePath = resolve(cwd, 'Dockerfile')\n const dockerignorePath = resolve(cwd, '.dockerignore')\n\n const pkgManager = detectPkgManager(cwd)\n const { serverDir, agentsDir, distDir } = await loadConfig(cwd)\n const dockerfile = generateDockerfile({\n pkgManager,\n sourceRoots: [topLevelDir(serverDir), topLevelDir(agentsDir)],\n distDir,\n hasConfigFile: existsSync(resolve(cwd, 'theo.config.ts')),\n hasPnpmWorkspace: existsSync(resolve(cwd, 'pnpm-workspace.yaml')),\n })\n\n // `wx` refuses an existing file in the same call that creates it. A separate exists check\n // followed by a write leaves a window, wider now that the config load sits between them.\n try {\n writeFileSync(dockerfilePath, dockerfile, { flag: options?.force ? 'w' : 'wx' })\n } catch (err) {\n if ((err as NodeJS.ErrnoException).code !== 'EEXIST') throw err\n console.log('\\n ⚠ Dockerfile already exists. Use --force to overwrite.\\n')\n return\n }\n writeFileSync(dockerignorePath, generateDockerignore(distDir))\n\n console.log(`\\n ✓ Generated Dockerfile (${pkgManager})`)\n console.log(` ✓ Generated .dockerignore`)\n console.log(`\\n Next steps:`)\n console.log(` docker build -t my-app .`)\n console.log(` docker run -p 3000:3000 my-app\\n`)\n}\n"],"mappings":";;;;;;;;;;;;;;;AAAA,SAAS,YAAY,qBAAqB;AAC1C,SAAS,eAAe;AAKxB,SAAS,iBAAiB,KAAyB;AACjD,MAAI,WAAW,QAAQ,KAAK,gBAAgB,CAAC,EAAG,QAAO;AACvD,MAAI,WAAW,QAAQ,KAAK,WAAW,CAAC,EAAG,QAAO;AAClD,SAAO;AACT;AAmBA,IAAM,cAAc;AAMpB,SAAS,YAAY,MAAsB;AACzC,SAAO,KAAK,QAAQ,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AAC/C;AAEA,SAAS,mBAAmB,OAAgC;AAC1D,QAAM,EAAE,YAAY,QAAQ,IAAI;AAChC,QAAM,aAAa;AAAA,IACjB,MAAM;AAAA,IACN,KAAK;AAAA,IACL,MAAM;AAAA,EACR,EAAE,UAAU;AAEZ,QAAM,WAAW;AAAA,IACf,MAAM;AAAA,IACN,KAAK;AAAA,IACL,MAAM;AAAA,EACR,EAAE,UAAU;AAGZ,QAAM,YAAY;AAAA,IAChB;AAAA,IACA;AAAA,IACA,GAAI,eAAe,UAAU,MAAM,mBAAmB,CAAC,qBAAqB,IAAI,CAAC;AAAA,EACnF;AAEA,QAAM,cAAc,CAAC,GAAG,IAAI,IAAI,MAAM,WAAW,CAAC,EAAE;AAAA,IAClD,CAAC,SAAS,4BAA4B,IAAI,MAAM,IAAI;AAAA,EACtD;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,UAAU,KAAK,GAAG,CAAC;AAAA,IAC3B;AAAA,IACA;AAAA,IACA,OAAO,WAAW;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA;AAAA,IAEA;AAAA,IACA;AAAA,IACA,4BAA4B,OAAO,MAAM,OAAO;AAAA,IAChD,GAAG;AAAA,IACH,GAAI,MAAM,gBAAgB,CAAC,0DAA0D,IAAI,CAAC;AAAA,IAC1F,GAAG,UAAU,IAAI,CAAC,SAAS,4BAA4B,IAAI,MAAM,IAAI,EAAE;AAAA,IACvE;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,WAAW;AAAA,IACpB;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAOA,SAAS,qBAAqB,UAAU,YAAoB;AAC1D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAG,OAAO;AAAA;AAAA,IAEV,GAAG,uBAAuB,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,KAAK,EAAE;AAAA,IAC/D;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,eAAsB,cAAc,SAA8C;AAChF,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,iBAAiB,QAAQ,KAAK,YAAY;AAChD,QAAM,mBAAmB,QAAQ,KAAK,eAAe;AAErD,QAAM,aAAa,iBAAiB,GAAG;AACvC,QAAM,EAAE,WAAW,WAAW,QAAQ,IAAI,MAAM,WAAW,GAAG;AAC9D,QAAM,aAAa,mBAAmB;AAAA,IACpC;AAAA,IACA,aAAa,CAAC,YAAY,SAAS,GAAG,YAAY,SAAS,CAAC;AAAA,IAC5D;AAAA,IACA,eAAe,WAAW,QAAQ,KAAK,gBAAgB,CAAC;AAAA,IACxD,kBAAkB,WAAW,QAAQ,KAAK,qBAAqB,CAAC;AAAA,EAClE,CAAC;AAID,MAAI;AACF,kBAAc,gBAAgB,YAAY,EAAE,MAAM,SAAS,QAAQ,MAAM,KAAK,CAAC;AAAA,EACjF,SAAS,KAAK;AACZ,QAAK,IAA8B,SAAS,SAAU,OAAM;AAC5D,YAAQ,IAAI,mEAA8D;AAC1E;AAAA,EACF;AACA,gBAAc,kBAAkB,qBAAqB,OAAO,CAAC;AAE7D,UAAQ,IAAI;AAAA,iCAA+B,UAAU,GAAG;AACxD,UAAQ,IAAI,kCAA6B;AACzC,UAAQ,IAAI;AAAA,cAAiB;AAC7B,UAAQ,IAAI,8BAA8B;AAC1C,UAAQ,IAAI;AAAA,CAAsC;AACpD;","names":[]}
@@ -2,7 +2,7 @@
2
2
  import "tsx/esm";
3
3
  import {
4
4
  detectProjectPackageManager
5
- } from "./chunk-JVXDEIT4.js";
5
+ } from "./chunk-I2IDWM26.js";
6
6
  import {
7
7
  cronScanDirs,
8
8
  isDiscoverableCronFile,
@@ -14,10 +14,10 @@ import {
14
14
  import "./chunk-Z7CJHDLS.js";
15
15
  import {
16
16
  loadConfig
17
- } from "./chunk-W2I6L4IJ.js";
17
+ } from "./chunk-35OI2TKT.js";
18
18
  import "./chunk-3QPVEJ7D.js";
19
19
  import "./chunk-O5JZ6ROY.js";
20
- import "./chunk-C2BRSL4W.js";
20
+ import "./chunk-PQWVT6JC.js";
21
21
  import "./chunk-L4V5V2TI.js";
22
22
  import "./chunk-MAJZ2L3A.js";
23
23
 
@@ -40,6 +40,15 @@ function pathTraversalRefusal(cwd, filePath) {
40
40
  };
41
41
  }
42
42
 
43
+ // src/cli/commands/generate-names.ts
44
+ function toPascalCase(name) {
45
+ return name.split(/[-/]/).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
46
+ }
47
+ function toCamelCase(name) {
48
+ const pascal = toPascalCase(name);
49
+ return pascal.charAt(0).toLowerCase() + pascal.slice(1);
50
+ }
51
+
43
52
  // src/cli/commands/generate-policy-placeholder.ts
44
53
  var UNDECIDED_POLICY_IDENT = "undecidedPolicy";
45
54
  function undecidedPolicyDeclaration(routePath, what) {
@@ -430,6 +439,66 @@ Nothing was written.`
430
439
  return { status: "created", filePath: routeIndexPath, kind: "resource", name };
431
440
  }
432
441
 
442
+ // src/cli/commands/generate-sandbox.ts
443
+ function generateSandboxTemplate(name) {
444
+ const camel = toCamelCase(name);
445
+ const base = name.split("/").pop() ?? name;
446
+ const snake = base.replace(/-/g, "_");
447
+ return [
448
+ `import { mkdtempSync } from 'node:fs'`,
449
+ `import { tmpdir } from 'node:os'`,
450
+ `import { join } from 'node:path'`,
451
+ ``,
452
+ `import {`,
453
+ ` createSandboxBackend,`,
454
+ ` resolveSandboxPosture,`,
455
+ ` SandboxNotAvailableError,`,
456
+ `} from '@theokit/sdk/sandbox'`,
457
+ `import { tool } from 'theokit/server/define'`,
458
+ `import { z } from 'zod'`,
459
+ ``,
460
+ `/**`,
461
+ ` * An agent tool that runs a shell command under bubblewrap confinement (Linux): the filesystem is`,
462
+ ` * read-only apart from a scratch directory and /tmp, the network is cut, and the environment is`,
463
+ ` * reduced to an allowlist. The command can still READ anything your user can read. Confinement`,
464
+ ` * limits what a command can change; it is not a boundary for hostile code, which needs a container`,
465
+ ` * or VM backend.`,
466
+ ` *`,
467
+ ` * Where bubblewrap is missing or cannot run (macOS, Windows, many containers) nothing confines the`,
468
+ ` * command, so the tool refuses with \`SandboxNotAvailableError\`. To run commands on the host anyway,`,
469
+ ` * with your user's full filesystem and network access, set THEOKIT_SANDBOX_ALLOW_UNCONFINED=1, and`,
470
+ ` * only for commands you trust.`,
471
+ ` *`,
472
+ ` * Connect it to your agent with \`.tool(...)\`:`,
473
+ ` *`,
474
+ ` * // agents/chat.ts`,
475
+ ` * import { ${camel}Tool } from './sandbox/${base}.js'`,
476
+ ` * AgentBuilder.create().model(...).tool(${camel}Tool).build()`,
477
+ ` */`,
478
+ `const MODE = 'workspace-write'`,
479
+ `let scratchDir: string | undefined`,
480
+ ``,
481
+ `export const ${camel}Tool = tool('${snake}')`,
482
+ ` .describe('Run a shell command and return its output.')`,
483
+ ` .input(z.object({ command: z.string().describe('The shell command to run, e.g. "ls -la"') }))`,
484
+ ` .execute(async ({ command }) => {`,
485
+ ` const posture = resolveSandboxPosture({ mode: MODE })`,
486
+ ` if (!posture.enforced && process.env.THEOKIT_SANDBOX_ALLOW_UNCONFINED !== '1') {`,
487
+ ` throw new SandboxNotAvailableError(`,
488
+ ` \`Refusing to run the command without confinement: \${posture.detail}. \` +`,
489
+ ` 'Install bubblewrap, or set THEOKIT_SANDBOX_ALLOW_UNCONFINED=1 to run it on the host.',`,
490
+ ` )`,
491
+ ` }`,
492
+ ` scratchDir ??= mkdtempSync(join(tmpdir(), '${base}-'))`,
493
+ ` const sandbox = createSandboxBackend({ mode: MODE, workDir: scratchDir, timeoutMs: 5_000 })`,
494
+ ` const { stdout, stderr, exitCode } = await sandbox.execute(command)`,
495
+ ` return exitCode === 0 ? stdout : \`exit \${exitCode}: \${stderr}\``,
496
+ ` })`,
497
+ ` .build()`,
498
+ ``
499
+ ].join("\n");
500
+ }
501
+
433
502
  // src/cli/commands/generate-schedule.ts
434
503
  import { basename, dirname as dirname2, extname, relative as relative2, resolve as resolve3, sep as sep2 } from "path";
435
504
 
@@ -589,13 +658,6 @@ function hasReservedSegment(name) {
589
658
  const basename2 = name.includes("/") ? name.split("/").pop() ?? name : name;
590
659
  return RESERVED_BASENAMES.has(basename2);
591
660
  }
592
- function toPascalCase(name) {
593
- return name.split(/[-/]/).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
594
- }
595
- function toCamelCase(name) {
596
- const pascal = toPascalCase(name);
597
- return pascal.charAt(0).toLowerCase() + pascal.slice(1);
598
- }
599
661
  function generateRouteTemplate(name, displayPath) {
600
662
  return [
601
663
  `import { route, type AccessDecision } from 'theokit/server/define'`,
@@ -733,36 +795,6 @@ function generateEvalTemplate(name) {
733
795
  ``
734
796
  ].join("\n");
735
797
  }
736
- function generateSandboxTemplate(name) {
737
- const camel = toCamelCase(name);
738
- const base = name.split("/").pop() ?? name;
739
- const snake = base.replace(/-/g, "_");
740
- return [
741
- `import { tool } from 'theokit/server/define'`,
742
- `import { LocalSandbox } from '@theokit/sdk/sandbox'`,
743
- `import { z } from 'zod'`,
744
- ``,
745
- `/**`,
746
- ` * A sandbox-backed agent tool. \`LocalSandbox\` (@theokit/sdk) runs a shell command with a timeout +`,
747
- ` * output cap, isolated from your app process \u2014 so the agent can run commands SAFELY. This IS an agent`,
748
- ` * capability: connect it to your agent with \`.tool(...)\`:`,
749
- ` *`,
750
- ` * // agents/chat.ts`,
751
- ` * import { ${camel}Tool } from './sandbox/${base}.js'`,
752
- ` * AgentBuilder.create().model(...).tool(${camel}Tool).build()`,
753
- ` */`,
754
- `export const ${camel}Tool = tool('${snake}')`,
755
- ` .describe('Run a shell command in an isolated sandbox and return its output.')`,
756
- ` .input(z.object({ command: z.string().describe('The shell command to run, e.g. "ls -la"') }))`,
757
- ` .execute(async ({ command }) => {`,
758
- ` const sandbox = new LocalSandbox({ timeoutMs: 5_000 })`,
759
- ` const { stdout, stderr, exitCode } = await sandbox.execute(command)`,
760
- ` return exitCode === 0 ? stdout : \`exit \${exitCode}: \${stderr}\``,
761
- ` })`,
762
- ` .build()`,
763
- ``
764
- ].join("\n");
765
- }
766
798
  function generateMemoryTemplate(_name) {
767
799
  return [
768
800
  `/**`,
@@ -1036,4 +1068,4 @@ export {
1036
1068
  generate,
1037
1069
  generateCommand
1038
1070
  };
1039
- //# sourceMappingURL=generate-6F24XT72.js.map
1071
+ //# sourceMappingURL=generate-4DY3MEYB.js.map