@standardagents/spec 0.12.9 → 0.13.0

package/dist/index.js

@@ -40,16 +40,37 @@ function validateToolName(name) {
   }
 }
 function defineTool(options) {
+  const variables = (options.variables ?? extractVariablesFromTenvSchema(options.tenvs ?? null)).map((entry) => ({
+    name: entry.name,
+    type: entry.type === "secret" ? "secret" : "text",
+    required: !!entry.required,
+    description: typeof entry.description === "string" ? entry.description : ""
+  }));
   return {
     description: options.description,
     args: options.args ?? null,
     execute: options.execute,
+    variables,
     tenvs: options.tenvs ?? null,
     executionMode: options.executionMode,
     executionProvider: options.executionProvider,
     uses: options.uses
   };
 }
+function extractVariablesFromTenvSchema(tenvSchema) {
+  if (!tenvSchema) return [];
+  const shape = tenvSchema.shape;
+  if (!shape) return [];
+  return Object.entries(shape).map(([name, fieldSchema]) => {
+    const zodSchema = fieldSchema;
+    return {
+      name,
+      type: "text",
+      required: !zodSchema.isOptional(),
+      description: zodSchema.description ?? ""
+    };
+  });
+}
 
 // src/prompts.ts
 function definePrompt(options) {
@@ -91,7 +112,17 @@ function definePrompt(options) {
   if (options.recentImageThreshold !== void 0 && (options.recentImageThreshold <= 0 || !Number.isInteger(options.recentImageThreshold))) {
     throw new Error("recentImageThreshold must be a positive integer");
   }
-  return options;
+  const normalizedVariables = Array.isArray(options.variables) ? options.variables.map((entry) => ({
+    name: entry.name,
+    type: entry.type === "secret" ? "secret" : "text",
+    required: !!entry.required,
+    scoped: !!entry.scoped,
+    description: typeof entry.description === "string" ? entry.description : ""
+  })) : void 0;
+  return {
+    ...options,
+    ...normalizedVariables ? { variables: normalizedVariables } : {}
+  };
 }
 
 // src/hooks.ts
@@ -145,6 +176,22 @@ function defineEffect(description, argsOrHandler, maybeHandler) {
 
 // src/agents.ts
 function defineAgent(options) {
+  const validateSessionBinding = (sideLabel, sessionKey, legacyKey) => {
+    const side = options[sideLabel];
+    if (!side) return;
+    const sessionBinding = side[sessionKey];
+    const legacyBinding = side[legacyKey];
+    if (typeof sessionBinding === "object" && sessionBinding !== null && !Array.isArray(sessionBinding)) {
+      if (!("name" in sessionBinding) || typeof sessionBinding.name !== "string" || !sessionBinding.name) {
+        throw new Error(`${sideLabel}.${sessionKey}.name is required when ${sideLabel}.${sessionKey} uses object form`);
+      }
+    }
+    if (typeof sessionBinding === "string" && typeof legacyBinding === "string" && sessionBinding !== legacyBinding) {
+      throw new Error(
+        `${sideLabel}.${sessionKey} and ${sideLabel}.${legacyKey} conflict. Use only ${sessionKey} (preferred) or keep values identical.`
+      );
+    }
+  };
   if (!options.name) {
     throw new Error("Agent name is required");
   }
@@ -187,6 +234,14 @@ function defineAgent(options) {
   if (!["ai_human", "dual_ai"].includes(type)) {
     throw new Error(`Invalid type '${type}'. Must be one of: ai_human, dual_ai`);
   }
+  validateSessionBinding("sideA", "sessionStop", "endSessionTool");
+  validateSessionBinding("sideA", "sessionFail", "failSessionTool");
+  validateSessionBinding("sideA", "sessionStatus", "statusTool");
+  if (options.sideB) {
+    validateSessionBinding("sideB", "sessionStop", "endSessionTool");
+    validateSessionBinding("sideB", "sessionFail", "failSessionTool");
+    validateSessionBinding("sideB", "sessionStatus", "statusTool");
+  }
   return {
     ...options,
     type