@standardagents/spec 0.44.0 → 0.45.0

package/dist/index.d.ts

@@ -404,11 +404,11 @@ type ResolveUsesState<Uses extends readonly string[]> = IsEmptyArray<Uses> exten
  * are constrained to only the declared tools. When `uses` is not declared or
  * is a regular string[], any tool name is allowed (backward compatible).
  *
- * @template State - Base state type
+ * @template _State - Reserved for compatibility.
  * @template Args - Tool arguments schema
  * @template Uses - Readonly array of allowed tool names
  */
-type UsesAwareExecute<State, Args extends ToolArgs | null, Uses extends readonly string[]> = Args extends ToolArgs ? (state: ResolveUsesState<Uses>, args: z.infer<Args>) => Promise<ToolResult> : (state: ResolveUsesState<Uses>) => Promise<ToolResult>;
+type UsesAwareExecute<_State, Args extends ToolArgs | null, Uses extends readonly string[]> = Args extends ToolArgs ? (state: ResolveUsesState<Uses>, args: z.infer<Args>) => Promise<ToolResult> : (state: ResolveUsesState<Uses>) => Promise<ToolResult>;
 type ToolAnnotations = Record<string, unknown>;
 /**
  * Options for defining a tool.
@@ -783,7 +783,7 @@ interface LLMProviderInterface {
      * @param modelId - Optional filter to get tools available for a specific model
      * @returns Record of tool name to tool definition (sync or async)
      */
-    getTools?(modelId?: string): Record<string, ToolDefinition<any, ToolArgs | null, ToolTenvs | null>> | Promise<Record<string, ToolDefinition<any, ToolArgs | null, ToolTenvs | null>>>;
+    getTools?(modelId?: string): Record<string, ToolDefinition<unknown, ToolArgs | null, ToolTenvs | null>> | Promise<Record<string, ToolDefinition<unknown, ToolArgs | null, ToolTenvs | null>>>;
     /**
      * Get an icon for this provider or a specific model.
      * Optional - providers may implement this to provide UI icons.
@@ -4206,6 +4206,7 @@ interface PromptToolConfig {
     options?: Record<string, unknown>;
 }
 /**
+ * @template _T - Reserved for compatibility.
  * @deprecated Removed in 0.2.0 — subagent relationships are no longer
  * declared in a prompt's `tools` array. Declare them on the owning side's
  * `subagents` array instead (see `SubagentRelationship`): the tool's `name`
@@ -4217,7 +4218,7 @@ interface PromptToolConfig {
  * lifecycle tools (`subagents`, `subagent_create`, `subagent_message`).
  * https://standardagentspec.com/0.2.0/getting-started/changelog
  */
-type SubagentToolConfig<T extends string = string> = never;
+type SubagentToolConfig<_T extends string = string> = never;
 /**
  * Reasoning configuration for models that support extended thinking.
  * Applies to models like OpenAI o1/o3, Anthropic Claude with extended thinking,
@@ -4610,12 +4611,12 @@ interface SubagentRelationship<Agent extends string = StandardAgentSpec.Agents>
      */
     readonly scopedEnv?: readonly string[];
     /**
-     * Property from `subagent_create` arguments used as the initial user
+     * Property from `subagent_create.arguments` used as the initial user
      * message when spawning an instance.
      */
     readonly initUserMessageProperty?: StandardAgentSpec.SchemaFields<Agent>;
     /**
-     * Property from `subagent_create` arguments containing attachment path(s)
+     * Property from `subagent_create.arguments` containing attachment path(s)
      * to include with the initial message.
      */
     readonly initAttachmentsProperty?: StandardAgentSpec.SchemaFields<Agent>;
@@ -5353,22 +5354,22 @@ interface ThreadEndpointAuth {
  */
 declare const THREAD_ENDPOINT_SYMBOL: unique symbol;
 /**
- * A controller that has been marked as a thread endpoint.
+ * A thread handler marked for ThreadState injection.
  *
  * The runtime detects this marker and wraps the handler with ThreadState injection.
  * The `__handler` property contains the original handler function that expects
  * `(req: Request, state: ThreadState)` arguments.
  */
-interface MarkedThreadEndpoint extends Controller {
+interface MarkedThreadEndpoint extends ThreadEndpointHandler {
     /** Marker symbol indicating this is a thread endpoint */
     [THREAD_ENDPOINT_SYMBOL]: true;
     /** The original handler function before wrapping */
     __handler: ThreadEndpointHandler;
 }
 /**
- * Type guard to check if a controller is a marked thread endpoint.
+ * Check whether a value carries a thread handler marker.
  */
-declare function isThreadEndpoint(controller: Controller): controller is MarkedThreadEndpoint;
+declare function isThreadEndpoint(controller: unknown): controller is MarkedThreadEndpoint;
 /**
  * Virtual module loader function.
  *
@@ -5535,7 +5536,7 @@ declare function defineController(controller: Controller, options?: EndpointOpti
  *
  * @param handler - The handler function receiving request, ThreadState, route params, and authentication context
  * @param options - Endpoint options, including the access level
- * @returns A Controller that can be used with the router
+ * @returns The marked original handler for runtime registration
  *
  * @example
  * ```typescript

package/dist/index.js

@@ -723,27 +723,29 @@ var THREAD_STREAM_REASONING_PARAM = "reasoning";
 // src/endpoints.ts
 var ENDPOINT_ACCESS_SYMBOL = Symbol.for("standardagents.endpointAccess");
 function getEndpointAccess(value) {
-  if ((typeof value === "function" || typeof value === "object" && value !== null) && value[ENDPOINT_ACCESS_SYMBOL] === "public") {
-    return "public";
+  if (typeof value === "function" || typeof value === "object" && value !== null) {
+    const access = Reflect.get(value, ENDPOINT_ACCESS_SYMBOL);
+    if (access === "public") return "public";
   }
   return "authenticated";
 }
 var THREAD_ENDPOINT_SYMBOL = Symbol.for("standardagents.threadEndpoint");
 function isThreadEndpoint(controller) {
-  return THREAD_ENDPOINT_SYMBOL in controller && controller[THREAD_ENDPOINT_SYMBOL] === true;
+  return typeof controller === "function" && THREAD_ENDPOINT_SYMBOL in controller && controller[THREAD_ENDPOINT_SYMBOL] === true;
 }
 function defineController(controller, options) {
   if (options?.access) {
-    controller[ENDPOINT_ACCESS_SYMBOL] = options.access;
+    Object.assign(controller, { [ENDPOINT_ACCESS_SYMBOL]: options.access });
   }
   return controller;
 }
 function defineThreadEndpoint(handler, options) {
-  const markedHandler = handler;
-  markedHandler[THREAD_ENDPOINT_SYMBOL] = true;
-  markedHandler.__handler = handler;
+  const marker = {
+    [THREAD_ENDPOINT_SYMBOL]: true
+  };
+  const markedHandler = Object.assign(handler, marker, { __handler: handler });
   if (options?.access) {
-    markedHandler[ENDPOINT_ACCESS_SYMBOL] = options.access;
+    Object.assign(markedHandler, { [ENDPOINT_ACCESS_SYMBOL]: options.access });
   }
   return markedHandler;
 }