@yanlinglabs/winter-agent-sdk 0.0.27 → 0.0.28

package/dist/index.d.ts

@@ -50,7 +50,7 @@ export type { PermissionMode, PermissionBehavior, PermissionRuleValue } from "./
 export type { PermissionUpdate, PermissionUpdateDestination, RuleSource } from "./permissions/types.js";
 export type { CanUseTool, PermissionResult, PermissionDecisionClassification, PermissionRequestPayload } from "./permissions/types.js";
 export { HOOK_EVENTS } from "./permissions/types.js";
-export type { HookEvent, HookEventName, HookSource, HookPermissionDecision, BaseHookInput, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, StopHookInput, SessionStartHookInput, SessionEndHookInput, NotificationHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, SubagentStartHookInput, SubagentStopHookInput, GenericHookInput, HookInput, AsyncHookJSONOutput, SyncHookJSONOutput, HookJSONOutput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, StopHookSpecificOutput, SubagentStartHookSpecificOutput, SubagentStopHookSpecificOutput, SessionStartHookSpecificOutput, NotificationHookSpecificOutput, PermissionRequestHookSpecificOutput, PermissionDeniedHookSpecificOutput, GenericHookSpecificOutput, HookSpecificOutput, HookCallback, HookCallbackMatcher, HookInvocationPayload, } from "./permissions/types.js";
+export type { HookEvent, HookEventName, HookSource, HookPermissionDecision, BaseHookInput, McpToolProvenance, PreToolUseHookInput, PostToolUseHookInput, PostToolUseFailureHookInput, UserPromptSubmitHookInput, StopHookInput, SessionStartHookInput, SessionEndHookInput, NotificationHookInput, PermissionRequestHookInput, PermissionDeniedHookInput, SubagentStartHookInput, SubagentStopHookInput, GenericHookInput, HookInput, AsyncHookJSONOutput, SyncHookJSONOutput, HookJSONOutput, PreToolUseHookSpecificOutput, PostToolUseHookSpecificOutput, PostToolUseFailureHookSpecificOutput, UserPromptSubmitHookSpecificOutput, StopHookSpecificOutput, SubagentStartHookSpecificOutput, SubagentStopHookSpecificOutput, SessionStartHookSpecificOutput, NotificationHookSpecificOutput, PermissionRequestHookSpecificOutput, PermissionDeniedHookSpecificOutput, GenericHookSpecificOutput, HookSpecificOutput, HookCallback, HookCallbackMatcher, HookInvocationPayload, } from "./permissions/types.js";
 export { CATALOG_TAG_RENAMES } from "@yanlinglabs/winter-provider-catalog";
 export { PluginManagerError, listMarketplaces, addMarketplace, removeMarketplace, updateMarketplace, installPlugin, uninstallPlugin, setPluginEnabled, updatePlugin, listPlugins } from "./plugins/manage.js";
 export type { PluginScope, PluginManagerOptions, MarketplaceInfo, InstalledPlugin, PluginListing } from "./plugins/manage.js";

package/dist/index.js

@@ -504,6 +504,8 @@ function buildHookInput(req, cwd) {
     ...req.agentID !== undefined ? { agent_id: req.agentID } : {},
     hook_event_name: req.event,
     ...req.toolName !== undefined ? { tool_name: req.toolName } : {},
+    ...req.mcpServerName !== undefined ? { mcp_server_name: req.mcpServerName } : {},
+    ...req.mcpToolName !== undefined ? { mcp_tool_name: req.mcpToolName } : {},
     ...req.input !== undefined ? { tool_input: req.input } : {},
     ...req.toolUseID !== undefined ? { tool_use_id: req.toolUseID } : {},
     ...payload
@@ -518,7 +520,7 @@ function makeHookHandler(hooks, cwd, abortController) {
       });
     });
   }
-  return async (payload) => {
+  return async (payload, handlerCtx) => {
     const req = payload;
     const callback = byId.get(req.hookId);
     if (!callback) {
@@ -529,6 +531,10 @@ function makeHookHandler(hooks, cwd, abortController) {
       controller.abort();
     else
       abortController?.signal.addEventListener("abort", () => controller.abort(), { once: true });
+    if (handlerCtx?.signal.aborted === true)
+      controller.abort();
+    else
+      handlerCtx?.signal.addEventListener("abort", () => controller.abort(), { once: true });
     const input = buildHookInput(req, cwd);
     let output;
     try {
@@ -1032,7 +1038,7 @@ function query(args) {
   return gen;
 }
 // src/version.ts
-var SDK_VERSION = "0.0.27";
+var SDK_VERSION = "0.0.28";
 // src/paths/project-key.ts
 var TRANSCRIPT_PROJECT_KEY_MAX_LENGTH = 64;
 var VENDOR_PROJECT_KEY_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;

package/dist/permissions/types.d.ts

@@ -101,13 +101,17 @@ export interface BaseHookInput {
     };
 }
 export type HookPermissionDecision = "allow" | "ask" | "deny" | "defer";
-export interface PreToolUseHookInput extends BaseHookInput {
+export interface McpToolProvenance {
+    mcp_server_name?: string;
+    mcp_tool_name?: string;
+}
+export interface PreToolUseHookInput extends BaseHookInput, McpToolProvenance {
     hook_event_name: "PreToolUse";
     tool_name: string;
     tool_input: unknown;
     tool_use_id: string;
 }
-export interface PostToolUseHookInput extends BaseHookInput {
+export interface PostToolUseHookInput extends BaseHookInput, McpToolProvenance {
     hook_event_name: "PostToolUse";
     tool_name: string;
     tool_input: unknown;
@@ -115,7 +119,7 @@ export interface PostToolUseHookInput extends BaseHookInput {
     tool_use_id: string;
     duration_ms?: number;
 }
-export interface PostToolUseFailureHookInput extends BaseHookInput {
+export interface PostToolUseFailureHookInput extends BaseHookInput, McpToolProvenance {
     hook_event_name: "PostToolUseFailure";
     tool_name: string;
     tool_input: unknown;
@@ -154,13 +158,13 @@ export interface NotificationHookInput extends BaseHookInput {
     title?: string;
     notification_type: string;
 }
-export interface PermissionRequestHookInput extends BaseHookInput {
+export interface PermissionRequestHookInput extends BaseHookInput, McpToolProvenance {
     hook_event_name: "PermissionRequest";
     tool_name: string;
     tool_input: unknown;
     permission_suggestions?: PermissionUpdate[];
 }
-export interface PermissionDeniedHookInput extends BaseHookInput {
+export interface PermissionDeniedHookInput extends BaseHookInput, McpToolProvenance {
     hook_event_name: "PermissionDenied";
     tool_name: string;
     tool_input: unknown;
@@ -186,6 +190,7 @@ export interface GenericHookInput extends BaseHookInput {
 export type HookInput = PreToolUseHookInput | PostToolUseHookInput | PostToolUseFailureHookInput | UserPromptSubmitHookInput | StopHookInput | SessionStartHookInput | SessionEndHookInput | NotificationHookInput | PermissionRequestHookInput | PermissionDeniedHookInput | SubagentStartHookInput | SubagentStopHookInput | GenericHookInput;
 export interface AsyncHookJSONOutput {
     async: true;
+    /** Milliseconds the background run may take (the runtime's default is 10 minutes). */
     asyncTimeout?: number;
 }
 export interface PreToolUseHookSpecificOutput {
@@ -293,6 +298,10 @@ export interface HookInvocationPayload {
     agentID?: string;
     toolUseID?: string;
     toolName?: string;
+    /** WS-24: for an MCP tool, the connected server that registered `toolName` -- see `McpToolProvenance`. */
+    mcpServerName?: string;
+    /** WS-24: for an MCP tool, the tool's own name on that server -- see `McpToolProvenance`. */
+    mcpToolName?: string;
     input?: Record<string, unknown>;
     payload?: unknown;
     policyVersion: string;

package/dist/protocol/frames.d.ts

@@ -58,8 +58,9 @@ export interface ControlResponseFrame {
  *     adapters send `{type: "ephemeral"}` with no ttl), so `ephemeral_5m_input_tokens` equals
  *     `cache_creation_input_tokens` and `ephemeral_1h_input_tokens` is 0;
  *   - `server_tool_use`: Winter's WebSearch/WebFetch run client-side, never as billed server tools: 0/0;
- *   - `output_tokens_details.thinking_tokens`: 0 -- providers' reasoning-token counts are not threaded
- *     through Winter's usage yet (they are included in `output_tokens`);
+ *   - `output_tokens_details.thinking_tokens`: the Responses family's reasoning-token count (WS-24
+ *     follow-up 1) when the turn's provider reported one, else 0 -- always a SUBSET of `output_tokens`,
+ *     never added on top. Anthropic reports no separate count, so a Claude-only turn stays 0;
  *   - `service_tier: "standard"`, `inference_geo: ""`, `iterations: []`, `speed: "standard"`: the
  *     pinned EMPTY_USAGE's own values.
  */

package/dist/settings/types.d.ts

@@ -18,12 +18,23 @@ export interface SettingsHookHandler {
     /** `"command"` is the only shape a settings file can express; see buildHookEntriesFromSettings. */
     type?: string;
     command?: string;
-    /** SECONDS (HookCallbackMatcher.timeout's pinned unit) -- converted to ms exactly once, at entry-build time. */
+    /** SECONDS (HookCallbackMatcher.timeout's pinned unit) -- converted to ms exactly once, at entry-build time. For an `async` handler, its background run's timeout. */
     timeout?: number;
+    /** WS-23: fail CLOSED on PreToolUse/PermissionRequest (an error, a timeout or malformed output denies the call). Only a literal `true`. */
+    failClosed?: boolean;
+    /**
+     * WS-24: run in the BACKGROUND -- the event never waits, the hook can never allow or deny anything, and
+     * what it later says (`systemMessage`, `additionalContext`) reaches the model at the next safe point as
+     * a reminder. Refused (the hook stays synchronous, and the refusal is reported) on a fail-closed
+     * PreToolUse/PermissionRequest hook. Only a literal `true`.
+     */
+    async?: boolean;
 }
 export interface SettingsHookMatcherGroup {
     matcher?: string;
     hooks?: SettingsHookHandler[];
+    /** WS-23: `failClosed` for every handler in the group. */
+    failClosed?: boolean;
 }
 /** Open-keyed for the same reason RuntimeHooksConfig is (protocol/config.ts): unknown event names are accepted, preserved and inert. */
 export type SettingsHooksConfig = Partial<Record<string, SettingsHookMatcherGroup[]>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanlinglabs/winter-agent-sdk",
-  "version": "0.0.27",
+  "version": "0.0.28",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -45,15 +45,15 @@
     }
   },
   "dependencies": {
-    "@yanlinglabs/winter-provider-catalog": "0.0.27"
+    "@yanlinglabs/winter-provider-catalog": "0.0.28"
   },
   "optionalDependencies": {
-    "@yanlinglabs/winter-agent-sdk-darwin-arm64": "0.0.27"
+    "@yanlinglabs/winter-agent-sdk-darwin-arm64": "0.0.28"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "@yanlinglabs/winter-agent-runtime": "0.0.27",
-    "@yanlinglabs/winter-conformance": "0.0.27"
+    "@yanlinglabs/winter-agent-runtime": "0.0.28",
+    "@yanlinglabs/winter-conformance": "0.0.28"
   },
   "scripts": {}
 }