struere 0.9.9 → 0.9.10

package/dist/bin/struere.js

@@ -20616,7 +20616,7 @@ function scaffoldFixture(cwd, name, slug) {
 }
 
 // src/cli/utils/plugin.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join4 } from "path";
 var registered = false;
 var VIRTUAL_MODULE_SOURCE = `
@@ -20731,6 +20731,7 @@ function defineTools(tools) {
       parameters: tool.parameters,
       handler: wrapHandler(tool.name, tool.handler),
       _originalHandler: tool.handler,
+      templateOnly: tool.templateOnly,
     }
   })
 }
@@ -20790,6 +20791,7 @@ var TYPE_DECLARATIONS = `declare module 'struere' {
     description: string
     parameters: ToolParameters
     handler: ToolHandler
+    templateOnly?: boolean
   }
 
   export interface ToolReference {
@@ -20798,6 +20800,7 @@ var TYPE_DECLARATIONS = `declare module 'struere' {
     parameters: ToolParameters
     handler: ToolHandler
     _originalHandler?: ToolHandler
+    templateOnly?: boolean
   }
 
   export interface AgentConfig {
@@ -20919,10 +20922,14 @@ function generateTypeDeclarations(cwd) {
   writeFileSync3(join4(struereDir, "index.d.ts"), TYPE_DECLARATIONS);
   writeFileSync3(join4(struereDir, "index.js"), VIRTUAL_MODULE_SOURCE);
   const shimDir = join4(cwd, "node_modules", "struere");
-  mkdirSync3(shimDir, { recursive: true });
-  writeFileSync3(join4(shimDir, "index.js"), VIRTUAL_MODULE_SOURCE);
-  writeFileSync3(join4(shimDir, "index.d.ts"), TYPE_DECLARATIONS);
-  writeFileSync3(join4(shimDir, "package.json"), JSON.stringify({ name: "struere", version: "0.0.0", type: "module", main: "index.js", types: "index.d.ts" }));
+  const realPkg = join4(shimDir, "package.json");
+  const isRealPackage = existsSync4(realPkg) && JSON.parse(readFileSync3(realPkg, "utf8")).version !== "0.0.0";
+  if (!isRealPackage) {
+    mkdirSync3(shimDir, { recursive: true });
+    writeFileSync3(join4(shimDir, "index.js"), VIRTUAL_MODULE_SOURCE);
+    writeFileSync3(join4(shimDir, "index.d.ts"), TYPE_DECLARATIONS);
+    writeFileSync3(join4(shimDir, "package.json"), JSON.stringify({ name: "struere", version: "0.0.0", type: "module", main: "index.js", types: "index.d.ts" }));
+  }
 }
 
 // src/cli/commands/docs.ts
@@ -20931,7 +20938,7 @@ import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as wr
 
 // src/cli/utils/loader.ts
 var import_yaml = __toESM(require_dist(), 1);
-import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync4 } from "fs";
 import { join as join5, basename } from "path";
 var pluginRegistered = false;
 var importCounter = 0;
@@ -21016,7 +21023,7 @@ function loadEvalSuites(dir) {
   const files = readdirSync(dir).filter((f) => f.endsWith(".eval.yaml") || f.endsWith(".eval.yml"));
   for (const file of files) {
     try {
-      const content = readFileSync3(join5(dir, file), "utf-8");
+      const content = readFileSync4(join5(dir, file), "utf-8");
       const parsed = import_yaml.default.parse(content);
       suites.push(parsed);
     } catch (err) {
@@ -21034,7 +21041,7 @@ function loadFixtures(dir) {
   const files = readdirSync(dir).filter((f) => f.endsWith(".fixture.yaml") || f.endsWith(".fixture.yml"));
   for (const file of files) {
     try {
-      const content = readFileSync3(join5(dir, file), "utf-8");
+      const content = readFileSync4(join5(dir, file), "utf-8");
       const parsed = import_yaml.default.parse(content);
       fixtures.push(parsed);
     } catch (err) {
@@ -25075,7 +25082,7 @@ var evalCommand = new Command("eval").description("Eval suite management");
 evalCommand.addCommand(runCommand);
 
 // src/cli/commands/templates.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 
 // src/cli/utils/whatsapp.ts
 function getToken3() {
@@ -25364,7 +25371,7 @@ templatesCommand.command("create <name>").description("Create a new message temp
   let components;
   if (opts.file) {
     try {
-      const fileContent = readFileSync4(opts.file, "utf-8");
+      const fileContent = readFileSync5(opts.file, "utf-8");
       const parsed = JSON.parse(fileContent);
       components = Array.isArray(parsed) ? parsed : parsed.components ?? [parsed];
     } catch (err) {
@@ -26000,7 +26007,7 @@ var compilePromptCommand = new Command("compile-prompt").description("Compile an
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.9.9",
+  version: "0.9.10",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",

package/dist/cli/index.js

@@ -1213,7 +1213,7 @@ function scaffoldFixture(cwd, name, slug) {
 }
 
 // src/cli/utils/plugin.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { join as join4 } from "path";
 var registered = false;
 var VIRTUAL_MODULE_SOURCE = `
@@ -1328,6 +1328,7 @@ function defineTools(tools) {
       parameters: tool.parameters,
       handler: wrapHandler(tool.name, tool.handler),
       _originalHandler: tool.handler,
+      templateOnly: tool.templateOnly,
     }
   })
 }
@@ -1387,6 +1388,7 @@ var TYPE_DECLARATIONS = `declare module 'struere' {
     description: string
     parameters: ToolParameters
     handler: ToolHandler
+    templateOnly?: boolean
   }
 
   export interface ToolReference {
@@ -1395,6 +1397,7 @@ var TYPE_DECLARATIONS = `declare module 'struere' {
     parameters: ToolParameters
     handler: ToolHandler
     _originalHandler?: ToolHandler
+    templateOnly?: boolean
   }
 
   export interface AgentConfig {
@@ -1516,10 +1519,14 @@ function generateTypeDeclarations(cwd) {
   writeFileSync3(join4(struereDir, "index.d.ts"), TYPE_DECLARATIONS);
   writeFileSync3(join4(struereDir, "index.js"), VIRTUAL_MODULE_SOURCE);
   const shimDir = join4(cwd, "node_modules", "struere");
-  mkdirSync3(shimDir, { recursive: true });
-  writeFileSync3(join4(shimDir, "index.js"), VIRTUAL_MODULE_SOURCE);
-  writeFileSync3(join4(shimDir, "index.d.ts"), TYPE_DECLARATIONS);
-  writeFileSync3(join4(shimDir, "package.json"), JSON.stringify({ name: "struere", version: "0.0.0", type: "module", main: "index.js", types: "index.d.ts" }));
+  const realPkg = join4(shimDir, "package.json");
+  const isRealPackage = existsSync4(realPkg) && JSON.parse(readFileSync3(realPkg, "utf8")).version !== "0.0.0";
+  if (!isRealPackage) {
+    mkdirSync3(shimDir, { recursive: true });
+    writeFileSync3(join4(shimDir, "index.js"), VIRTUAL_MODULE_SOURCE);
+    writeFileSync3(join4(shimDir, "index.d.ts"), TYPE_DECLARATIONS);
+    writeFileSync3(join4(shimDir, "package.json"), JSON.stringify({ name: "struere", version: "0.0.0", type: "module", main: "index.js", types: "index.d.ts" }));
+  }
 }
 
 // src/cli/commands/docs.ts
@@ -1530,7 +1537,7 @@ import { join as join6, dirname as dirname2 } from "path";
 import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
 
 // src/cli/utils/loader.ts
-import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync5, readdirSync, readFileSync as readFileSync4 } from "fs";
 import { join as join5, basename } from "path";
 import YAML from "yaml";
 var pluginRegistered = false;
@@ -1616,7 +1623,7 @@ function loadEvalSuites(dir) {
   const files = readdirSync(dir).filter((f) => f.endsWith(".eval.yaml") || f.endsWith(".eval.yml"));
   for (const file of files) {
     try {
-      const content = readFileSync3(join5(dir, file), "utf-8");
+      const content = readFileSync4(join5(dir, file), "utf-8");
       const parsed = YAML.parse(content);
       suites.push(parsed);
     } catch (err) {
@@ -1634,7 +1641,7 @@ function loadFixtures(dir) {
   const files = readdirSync(dir).filter((f) => f.endsWith(".fixture.yaml") || f.endsWith(".fixture.yml"));
   for (const file of files) {
     try {
-      const content = readFileSync3(join5(dir, file), "utf-8");
+      const content = readFileSync4(join5(dir, file), "utf-8");
       const parsed = YAML.parse(content);
       fixtures.push(parsed);
     } catch (err) {
@@ -5719,7 +5726,7 @@ evalCommand.addCommand(runCommand);
 // src/cli/commands/templates.ts
 import { Command as Command15 } from "commander";
 import chalk17 from "chalk";
-import { readFileSync as readFileSync4 } from "fs";
+import { readFileSync as readFileSync5 } from "fs";
 import { confirm as confirm6 } from "@inquirer/prompts";
 
 // src/cli/utils/whatsapp.ts
@@ -6009,7 +6016,7 @@ templatesCommand.command("create <name>").description("Create a new message temp
   let components;
   if (opts.file) {
     try {
-      const fileContent = readFileSync4(opts.file, "utf-8");
+      const fileContent = readFileSync5(opts.file, "utf-8");
       const parsed = JSON.parse(fileContent);
       components = Array.isArray(parsed) ? parsed : parsed.components ?? [parsed];
     } catch (err) {
@@ -6653,7 +6660,7 @@ var compilePromptCommand = new Command17("compile-prompt").description("Compile
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.9.9",
+  version: "0.9.10",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",

package/dist/cli/utils/plugin.d.ts

@@ -1,4 +1,4 @@
-export declare const VIRTUAL_MODULE_SOURCE = "\nfunction defineAgent(config) {\n  if (!config.name) throw new Error('Agent name is required')\n  if (!config.version) throw new Error('Agent version is required')\n  if (!config.systemPrompt) throw new Error('System prompt is required')\n  return {\n    model: {\n      provider: 'xai',\n      name: 'grok-4-1-fast',\n      temperature: 0.7,\n      maxTokens: 4096,\n    },\n    ...config,\n  }\n}\n\nfunction defineRole(config) {\n  if (!config.name) throw new Error('Role name is required')\n  if (!config.policies || config.policies.length === 0) throw new Error('Role must have at least one policy')\n  for (const policy of config.policies) {\n    if (!policy.resource) throw new Error('Policy resource is required')\n    if (!policy.actions || policy.actions.length === 0) throw new Error('Policy must have at least one action')\n    if (!policy.effect) throw new Error('Policy effect is required')\n  }\n  return {\n    ...config,\n    scopeRules: config.scopeRules || [],\n    fieldMasks: config.fieldMasks || [],\n  }\n}\n\nfunction validateObjectProperties(schema, path) {\n  if (schema.type === 'object' && !schema.properties) {\n    throw new Error('Schema field \"' + path + '\" has type \"object\" but is missing \"properties\". All object fields must declare their properties.')\n  }\n  if (schema.properties) {\n    for (const [key, value] of Object.entries(schema.properties)) {\n      validateObjectProperties(value, path ? path + '.' + key : key)\n    }\n  }\n  if (schema.items) {\n    validateObjectProperties(schema.items, path + '[]')\n  }\n}\n\nfunction defineData(config) {\n  if (!config.name) throw new Error('Data type name is required')\n  if (!config.slug) throw new Error('Data type slug is required')\n  if (!config.schema) throw new Error('Data type schema is required')\n  if (config.schema.type !== 'object') throw new Error('Data type schema must be an object type')\n  if (config.schema.properties) {\n    for (const [key, value] of Object.entries(config.schema.properties)) {\n      validateObjectProperties(value, key)\n    }\n  }\n  if (config.boundToRole !== undefined && config.boundToRole === '') throw new Error('boundToRole cannot be an empty string')\n  if (config.userIdField !== undefined && !config.boundToRole) throw new Error('userIdField requires boundToRole to be set')\n  const userIdField = config.boundToRole && !config.userIdField ? 'userId' : config.userIdField\n  return {\n    ...config,\n    searchFields: config.searchFields || [],\n    userIdField,\n  }\n}\n\nfunction defineTrigger(config) {\n  const VALID_ACTIONS = ['created', 'updated', 'deleted']\n  if (!config.name) throw new Error('Trigger name is required')\n  if (!config.slug) throw new Error('Trigger slug is required')\n  if (!config.on) throw new Error('Trigger \"on\" configuration is required')\n  if (!config.on.entityType) throw new Error('Trigger entityType is required')\n  if (!config.on.action || !VALID_ACTIONS.includes(config.on.action)) throw new Error('Trigger action must be one of: ' + VALID_ACTIONS.join(', '))\n  if (!config.actions || config.actions.length === 0) throw new Error('Trigger must have at least one action')\n  for (const action of config.actions) {\n    if (!action.tool) throw new Error('Trigger action tool is required')\n    if (!action.args || typeof action.args !== 'object') throw new Error('Trigger action args must be an object')\n  }\n  if (config.schedule) {\n    if (config.schedule.delay !== undefined && config.schedule.at !== undefined) throw new Error('Trigger schedule cannot have both \"delay\" and \"at\"')\n    if (config.schedule.delay !== undefined && typeof config.schedule.delay !== 'number') throw new Error('Trigger schedule.delay must be a number')\n    if (config.schedule.at !== undefined && typeof config.schedule.at !== 'string') throw new Error('Trigger schedule.at must be a string')\n  }\n  if (config.retry) {\n    if (config.retry.maxAttempts !== undefined && (typeof config.retry.maxAttempts !== 'number' || config.retry.maxAttempts < 1)) throw new Error('Trigger retry.maxAttempts must be a positive number')\n    if (config.retry.backoffMs !== undefined && (typeof config.retry.backoffMs !== 'number' || config.retry.backoffMs < 0)) throw new Error('Trigger retry.backoffMs must be a non-negative number')\n  }\n  return config\n}\n\nfunction wrapHandler(name, handler) {\n  return async (params, context) => {\n    try {\n      return await handler(params, context)\n    } catch (error) {\n      console.error('Tool \"' + name + '\" execution error:', error)\n      throw error\n    }\n  }\n}\n\nfunction defineTools(tools) {\n  return tools.map((tool) => {\n    if (!tool.name) throw new Error('Tool name is required')\n    if (!tool.description) throw new Error('Tool \"' + tool.name + '\" requires a description')\n    if (!tool.parameters) throw new Error('Tool \"' + tool.name + '\" requires parameters definition')\n    if (typeof tool.handler !== 'function') throw new Error('Tool \"' + tool.name + '\" requires a handler function')\n    return {\n      name: tool.name,\n      description: tool.description,\n      parameters: tool.parameters,\n      handler: wrapHandler(tool.name, tool.handler),\n      _originalHandler: tool.handler,\n    }\n  })\n}\n\nexport { defineAgent, defineRole, defineData, defineTrigger, defineTools }\n";
+export declare const VIRTUAL_MODULE_SOURCE = "\nfunction defineAgent(config) {\n  if (!config.name) throw new Error('Agent name is required')\n  if (!config.version) throw new Error('Agent version is required')\n  if (!config.systemPrompt) throw new Error('System prompt is required')\n  return {\n    model: {\n      provider: 'xai',\n      name: 'grok-4-1-fast',\n      temperature: 0.7,\n      maxTokens: 4096,\n    },\n    ...config,\n  }\n}\n\nfunction defineRole(config) {\n  if (!config.name) throw new Error('Role name is required')\n  if (!config.policies || config.policies.length === 0) throw new Error('Role must have at least one policy')\n  for (const policy of config.policies) {\n    if (!policy.resource) throw new Error('Policy resource is required')\n    if (!policy.actions || policy.actions.length === 0) throw new Error('Policy must have at least one action')\n    if (!policy.effect) throw new Error('Policy effect is required')\n  }\n  return {\n    ...config,\n    scopeRules: config.scopeRules || [],\n    fieldMasks: config.fieldMasks || [],\n  }\n}\n\nfunction validateObjectProperties(schema, path) {\n  if (schema.type === 'object' && !schema.properties) {\n    throw new Error('Schema field \"' + path + '\" has type \"object\" but is missing \"properties\". All object fields must declare their properties.')\n  }\n  if (schema.properties) {\n    for (const [key, value] of Object.entries(schema.properties)) {\n      validateObjectProperties(value, path ? path + '.' + key : key)\n    }\n  }\n  if (schema.items) {\n    validateObjectProperties(schema.items, path + '[]')\n  }\n}\n\nfunction defineData(config) {\n  if (!config.name) throw new Error('Data type name is required')\n  if (!config.slug) throw new Error('Data type slug is required')\n  if (!config.schema) throw new Error('Data type schema is required')\n  if (config.schema.type !== 'object') throw new Error('Data type schema must be an object type')\n  if (config.schema.properties) {\n    for (const [key, value] of Object.entries(config.schema.properties)) {\n      validateObjectProperties(value, key)\n    }\n  }\n  if (config.boundToRole !== undefined && config.boundToRole === '') throw new Error('boundToRole cannot be an empty string')\n  if (config.userIdField !== undefined && !config.boundToRole) throw new Error('userIdField requires boundToRole to be set')\n  const userIdField = config.boundToRole && !config.userIdField ? 'userId' : config.userIdField\n  return {\n    ...config,\n    searchFields: config.searchFields || [],\n    userIdField,\n  }\n}\n\nfunction defineTrigger(config) {\n  const VALID_ACTIONS = ['created', 'updated', 'deleted']\n  if (!config.name) throw new Error('Trigger name is required')\n  if (!config.slug) throw new Error('Trigger slug is required')\n  if (!config.on) throw new Error('Trigger \"on\" configuration is required')\n  if (!config.on.entityType) throw new Error('Trigger entityType is required')\n  if (!config.on.action || !VALID_ACTIONS.includes(config.on.action)) throw new Error('Trigger action must be one of: ' + VALID_ACTIONS.join(', '))\n  if (!config.actions || config.actions.length === 0) throw new Error('Trigger must have at least one action')\n  for (const action of config.actions) {\n    if (!action.tool) throw new Error('Trigger action tool is required')\n    if (!action.args || typeof action.args !== 'object') throw new Error('Trigger action args must be an object')\n  }\n  if (config.schedule) {\n    if (config.schedule.delay !== undefined && config.schedule.at !== undefined) throw new Error('Trigger schedule cannot have both \"delay\" and \"at\"')\n    if (config.schedule.delay !== undefined && typeof config.schedule.delay !== 'number') throw new Error('Trigger schedule.delay must be a number')\n    if (config.schedule.at !== undefined && typeof config.schedule.at !== 'string') throw new Error('Trigger schedule.at must be a string')\n  }\n  if (config.retry) {\n    if (config.retry.maxAttempts !== undefined && (typeof config.retry.maxAttempts !== 'number' || config.retry.maxAttempts < 1)) throw new Error('Trigger retry.maxAttempts must be a positive number')\n    if (config.retry.backoffMs !== undefined && (typeof config.retry.backoffMs !== 'number' || config.retry.backoffMs < 0)) throw new Error('Trigger retry.backoffMs must be a non-negative number')\n  }\n  return config\n}\n\nfunction wrapHandler(name, handler) {\n  return async (params, context) => {\n    try {\n      return await handler(params, context)\n    } catch (error) {\n      console.error('Tool \"' + name + '\" execution error:', error)\n      throw error\n    }\n  }\n}\n\nfunction defineTools(tools) {\n  return tools.map((tool) => {\n    if (!tool.name) throw new Error('Tool name is required')\n    if (!tool.description) throw new Error('Tool \"' + tool.name + '\" requires a description')\n    if (!tool.parameters) throw new Error('Tool \"' + tool.name + '\" requires parameters definition')\n    if (typeof tool.handler !== 'function') throw new Error('Tool \"' + tool.name + '\" requires a handler function')\n    return {\n      name: tool.name,\n      description: tool.description,\n      parameters: tool.parameters,\n      handler: wrapHandler(tool.name, tool.handler),\n      _originalHandler: tool.handler,\n      templateOnly: tool.templateOnly,\n    }\n  })\n}\n\nexport { defineAgent, defineRole, defineData, defineTrigger, defineTools }\n";
 export declare function registerStruerePlugin(): void;
 export declare function generateTypeDeclarations(cwd: string): void;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/cli/utils/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/plugin.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,+tKAqHjC,CAAA;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAkB5C;AA8JD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAc1D"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/plugin.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,uwKAsHjC,CAAA;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAkB5C;AAgKD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAkB1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "struere",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Build, test, and deploy AI agents",
   "keywords": [
     "ai",