@standardagents/spec 0.43.1 → 0.44.0

package/dist/index.js

@@ -13,8 +13,8 @@ function defineProvider(definition) {
   if (typeof definition.baseProvider !== "function") {
     throw new Error("baseProvider must be a provider factory function");
   }
-  const factory = ((config) => {
-    const baseProvider = definition.baseProvider(config);
+  const factory = ((config, context) => {
+    const baseProvider = context ? definition.baseProvider(config, context) : definition.baseProvider(config);
     const commonContext = {
       providerName: definition.name,
       config,
@@ -25,11 +25,11 @@ function defineProvider(definition) {
       specificationVersion: "1",
       generate: (request) => {
         const next = () => baseProvider.generate(request);
-        return Promise.resolve(definition.overrides?.generate?.({ ...commonContext, request }, next) ?? next());
+        return Promise.resolve(definition.overrides?.generate?.({ ...commonContext, state: context?.state, request }, next) ?? next());
       },
       stream: (request) => {
         const next = () => baseProvider.stream(request);
-        return Promise.resolve(definition.overrides?.stream?.({ ...commonContext, request }, next) ?? next());
+        return Promise.resolve(definition.overrides?.stream?.({ ...commonContext, state: context?.state, request }, next) ?? next());
       }
     };
     if (definition.overrides?.supportsModel || baseProvider.supportsModel) {
@@ -83,7 +83,7 @@ function defineProvider(definition) {
           return baseProvider.inspectRequest(request);
         };
         return Promise.resolve(
-          definition.overrides?.inspectRequest?.({ ...commonContext, request }, next) ?? next()
+          definition.overrides?.inspectRequest?.({ ...commonContext, state: context?.state, request }, next) ?? next()
         );
       };
     }
@@ -91,7 +91,7 @@ function defineProvider(definition) {
       provider.getResponseMetadata = (summary, signal) => {
         const next = () => baseProvider.getResponseMetadata?.(summary, signal) ?? Promise.resolve(null);
         return Promise.resolve(
-          definition.overrides?.getResponseMetadata?.({ ...commonContext, summary, signal }, next) ?? next()
+          definition.overrides?.getResponseMetadata?.({ ...commonContext, state: context?.state, summary, signal }, next) ?? next()
         );
       };
     }
@@ -147,10 +147,12 @@ function defineTool(options) {
     name: entry.name,
     type: entry.type === "secret" ? "secret" : "text",
     required: !!entry.required,
+    scoped: entry.scoped,
     description: typeof entry.description === "string" ? entry.description : ""
   }));
   return {
     description: options.description,
+    annotations: options.annotations,
     args: options.args ?? null,
     execute: options.execute,
     variables,
@@ -200,18 +202,10 @@ function definePrompt(options) {
   }
   if (options.reasoning) {
     if (options.reasoning.level !== void 0) {
-      if (typeof options.reasoning.level !== "number" || options.reasoning.level < 0 || options.reasoning.level > 100) {
+      if (typeof options.reasoning.level !== "number" || !Number.isFinite(options.reasoning.level) || options.reasoning.level < 0 || options.reasoning.level > 100) {
         throw new Error("reasoning.level must be a number between 0 and 100");
       }
     }
-    if (options.reasoning.effort && !["low", "medium", "high"].includes(options.reasoning.effort)) {
-      throw new Error(
-        `Invalid reasoning.effort '${options.reasoning.effort}'. Must be one of: low, medium, high`
-      );
-    }
-    if (options.reasoning.level !== void 0 && options.reasoning.effort !== void 0) {
-      console.warn("Both reasoning.level and reasoning.effort provided. level takes precedence. effort is deprecated.");
-    }
   }
   if (options.recentImageThreshold !== void 0 && (options.recentImageThreshold <= 0 || !Number.isInteger(options.recentImageThreshold))) {
     throw new Error("recentImageThreshold must be a positive integer");
@@ -247,7 +241,10 @@ var VALID_HOOKS = [
   "after_tool_call_success",
   "after_tool_call_failure",
   "tool_call_started",
-  "tool_call_done"
+  "tool_call_done",
+  "user_client_attached",
+  "user_client_detached",
+  "user_value_changed"
 ];
 function defineHook(options) {
   if (!VALID_HOOKS.includes(options.hook)) {
@@ -307,6 +304,40 @@ function isHandler(value) {
   return typeof value === "object" && value !== null && HANDLER_SYMBOL in value && value[HANDLER_SYMBOL] === true;
 }
 
+// src/packing.ts
+function isPacked(metadata) {
+  return !!metadata?.__package;
+}
+function belongsToPackage(metadata, packageId) {
+  return metadata?.__package?.packageId === packageId;
+}
+function isVisibleInNamespace(metadata, namespace, isEntryPoint = false) {
+  const hasPkg = isPacked(metadata);
+  if (namespace.type === "global") {
+    return !hasPkg || isEntryPoint;
+  }
+  const isOwnPackage = hasPkg && metadata.__package.packageId === namespace.packageId;
+  return isOwnPackage || hasPkg && isEntryPoint;
+}
+function parseQualifiedName(name) {
+  if (name.startsWith("@")) {
+    const firstSlash = name.indexOf("/");
+    if (firstSlash === -1) {
+      return [null, name];
+    }
+    const secondSlash = name.indexOf("/", firstSlash + 1);
+    if (secondSlash === -1) {
+      return [null, name];
+    }
+    return [name.substring(0, secondSlash), name.substring(secondSlash + 1)];
+  }
+  const separatorIndex = name.indexOf("/");
+  if (separatorIndex === -1) {
+    return [null, name];
+  }
+  return [name.substring(0, separatorIndex), name.substring(separatorIndex + 1)];
+}
+
 // src/validation.ts
 var DEFINITION_ISSUE_CODES = [
   "agent_name_missing",
@@ -321,8 +352,8 @@ var DEFINITION_ISSUE_CODES = [
   "agent_legacy_type",
   "agent_session_binding_legacy_string",
   "agent_session_binding_invalid",
-  "agent_stop_tool_response_property_missing",
   "agent_max_steps_invalid",
+  "agent_stop_tool_missing",
   "agent_max_session_turns_invalid",
   "agent_tool_description_missing",
   "agent_parent_hooks_invalid",
@@ -463,11 +494,11 @@ function validateAgentDefinition(def) {
       );
     }
     if (backing === "prompt") {
-      if (side.stopTool !== void 0 && side.stopToolResponseProperty === void 0) {
+      if (side.stopToolResponseProperty !== void 0 && !side.stopTool) {
         error(
-          "agent_stop_tool_response_property_missing",
+          "agent_stop_tool_missing",
           `${sideKey}.stopToolResponseProperty`,
-          `${sideKey}.stopToolResponseProperty is required when ${sideKey}.stopTool is set`
+          `${sideKey}.stopToolResponseProperty requires stopTool`
         );
       }
       if (side.maxSteps !== void 0 && (typeof side.maxSteps !== "number" || side.maxSteps <= 0)) {
@@ -519,7 +550,7 @@ function validateAgentDefinition(def) {
             error(
               "subagent_legacy_name",
               `${path}.name`,
-              `'name' was removed in 0.2.0 \u2014 the relationship name is 'as' (defaulting to the agent name) and the target agent is 'agent'. ${MIGRATION_URL}`
+              `'name' was removed in 0.2.0 \u2014 the relationship name is 'as' (defaulting to the unqualified agent name) and the target agent is 'agent'. ${MIGRATION_URL}`
             );
           }
           if (relationship.resumable !== void 0) {
@@ -559,7 +590,7 @@ function validateAgentDefinition(def) {
               `'maxInstances' must be a positive number when provided`
             );
           }
-          const relationshipName = typeof relationship.as === "string" && relationship.as ? relationship.as : relationship.agent;
+          const relationshipName = typeof relationship.as === "string" && relationship.as ? relationship.as : parseQualifiedName(relationship.agent)[1];
           if (RESERVED_NAMES.has(relationshipName)) {
             error(
               "subagent_relationship_reserved_name",
@@ -761,6 +792,28 @@ var ProviderError = class extends Error {
     return this.code === "rate_limit" || this.code === "server_error" || this.code === "timeout";
   }
 };
+async function resolveRequestReasoningLevels(request, lookup) {
+  request.signal?.throwIfAborted();
+  if (request.reasoning?.level === void 0) return void 0;
+  if (request.reasoning.levels !== void 0) return request.reasoning.levels;
+  let timer;
+  let abort;
+  try {
+    return await Promise.race([
+      Promise.resolve().then(() => lookup(request.model)).then((capabilities) => capabilities?.reasoningLevels, () => void 0),
+      new Promise((resolve) => {
+        timer = setTimeout(() => resolve(void 0), 250);
+      }),
+      new Promise((_resolve, reject) => {
+        abort = () => reject(request.signal?.reason);
+        request.signal?.addEventListener("abort", abort, { once: true });
+      })
+    ]);
+  } finally {
+    if (timer !== void 0) clearTimeout(timer);
+    if (abort) request.signal?.removeEventListener("abort", abort);
+  }
+}
 function mapReasoningLevel(level, reasoningLevels) {
   if (!reasoningLevels) return null;
   const breakpoints = Object.keys(reasoningLevels).map(Number).sort((a, b) => a - b);
@@ -777,22 +830,6 @@ function mapReasoningLevel(level, reasoningLevels) {
   return reasoningLevels[nearest];
 }
 
-// src/packing.ts
-function isPacked(metadata) {
-  return !!metadata?.__package;
-}
-function belongsToPackage(metadata, packageId) {
-  return metadata?.__package?.packageId === packageId;
-}
-function isVisibleInNamespace(metadata, namespace, isEntryPoint = false) {
-  const hasPkg = isPacked(metadata);
-  if (namespace.type === "global") {
-    return !hasPkg || isEntryPoint;
-  }
-  const isOwnPackage = hasPkg && metadata.__package.packageId === namespace.packageId;
-  return isOwnPackage || hasPkg && isEntryPoint;
-}
-
 // src/decisions.ts
 function decide(state, options) {
   return state.decide(options);
@@ -833,9 +870,11 @@ export {
   isUserRoom,
   isVisibleInNamespace,
   mapReasoningLevel,
+  parseQualifiedName,
   providerConst,
   providerEnv,
   providerValue,
+  resolveRequestReasoningLevels,
   validateAgentDefinition,
   validateToolName
 };