@yanlinglabs/winter-agent-sdk 0.0.43 → 0.0.44

package/dist/index.d.ts

@@ -30,7 +30,7 @@ export { SDK_VERSION } from "./version.js";
 export { MESSAGING_CONTROL_SUBTYPES, MESSAGING_CONTROL_SUBTYPE_LIST, MESSAGING_HOST_REQUEST_SUBTYPES, MESSAGING_RUNTIME_REQUEST_SUBTYPES, resolveFacetTarget } from "./protocol/messaging.js";
 export { isRuntimeAddress, isGlobalAgentMessage, isDeliveryOutcome, isListedRuntimeObjectArray, isPermissionClassLabel, isMessagingDeliverRequest, isMessagingChildRequest, isMessagingSubscribeIdleRequest, isMessagingReadNotificationsRequest, isMessagingNotificationsPage, isMessagingIdleNoticePayload, isNotificationRecord, } from "./protocol/messaging.js";
 export type { MessagingControlSubtype, MessagingDeliverRequest, MessagingChildRequest, MessagingSubscribeIdleRequest, MessagingSenderClassResponse, MessagingReadNotificationsRequest, MessagingNotificationsPage, MessagingIdleNoticePayload, } from "./protocol/messaging.js";
-export type { ProtocolVersion, WinterFrame, SdkMessage as ProtocolSdkMessage, InitFrame, UserFrame, DataFrame, ControlRequestFrame, ControlResponseFrame, ControlCancelRequestFrame, WireResultUsage, UnknownFrame, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKPermissionDenial, SDKTaskStartedMessage, SDKTaskNotificationMessage, SDKTaskUpdatedMessage, SDKTaskProgressMessage, SDKBackgroundTasksChangedMessage, SDKLocalCommandOutputMessage, BackgroundTaskMessage, SDKCompactBoundaryMessage, SDKSessionStateChangedMessage, SDKInformationalMessage, WireContentBlock, WireStreamEvent, WireStreamEventDelta, SDKPartialAssistantMessage, SDKAssistantMessageError, SDKAPIRetryMessage, SDKRateLimitEvent, SDKRateLimitInfo, SDKAuthStatusMessage, SDKThinkingTokensMessage, SDKModelRefusalFallbackMessage, SDKModelRefusalNoFallbackMessage, SDKReasoningSummaryMessage, SDKModelSwitchMessage, SDKContinuityWarningMessage, } from "./protocol/frames.js";
+export type { ProtocolVersion, WinterFrame, SdkMessage as ProtocolSdkMessage, InitFrame, UserFrame, DataFrame, ControlRequestFrame, ControlResponseFrame, ControlCancelRequestFrame, WireResultUsage, UnknownFrame, SDKHookStartedMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKPermissionDeniedMessage, SDKPermissionDenial, SDKTaskStartedMessage, SDKTaskNotificationMessage, SDKTaskUpdatedMessage, SDKTaskProgressMessage, SDKBackgroundTasksChangedMessage, SDKLocalCommandOutputMessage, BackgroundTaskMessage, SDKCompactBoundaryMessage, SDKSessionStateChangedMessage, SDKInformationalMessage, SDKHostInputFoldedMessage, WireContentBlock, WireStreamEvent, WireStreamEventDelta, SDKPartialAssistantMessage, SDKAssistantMessageError, SDKAPIRetryMessage, SDKRateLimitEvent, SDKRateLimitInfo, SDKAuthStatusMessage, SDKThinkingTokensMessage, SDKModelRefusalFallbackMessage, SDKModelRefusalNoFallbackMessage, SDKReasoningSummaryMessage, SDKModelSwitchMessage, SDKContinuityWarningMessage, } from "./protocol/frames.js";
 export { resolveWinterHome, resolveKeychainServiceForProfile, isUnset } from "./paths/home.js";
 export { transcriptProjectKey, TRANSCRIPT_PROJECT_KEY_MAX_LENGTH, isVendorCompliantProjectKey } from "./paths/project-key.js";
 export { compatibilityKeys } from "./paths/keys.js";

package/dist/index.js

@@ -1146,6 +1146,11 @@ function query(args) {
   gen.reconnectMcpServer = async (serverName) => {
     await sendControlRequest("mcp_reconnect", { serverName });
   };
+  gen.clearQueuedInput = async () => {
+    const payload = await sendControlRequest("clear_queued_input", undefined);
+    const cleared = typeof payload === "object" && payload !== null ? payload.cleared : undefined;
+    return { cleared: typeof cleared === "number" ? cleared : 0 };
+  };
   gen.supportedModels = async () => {
     const payload = await sendControlRequest("list_models", undefined);
     return Array.isArray(payload) ? payload : [];
@@ -1271,7 +1276,7 @@ function withTestKeychainRedirect(env) {
   return { ...env, [TEST_KEYCHAIN_ENV]: redirect };
 }
 // src/version.ts
-var SDK_VERSION = "0.0.43";
+var SDK_VERSION = "0.0.44";
 // 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/protocol/frames.d.ts

@@ -637,6 +637,28 @@ export interface SDKSessionStateChangedMessage {
     session_id: string;
     [k: string]: unknown;
 }
+/**
+ * WINTER-ONLY: host input was FOLDED into the running turn.
+ *
+ * A `user` input the host sends while a turn is running waits; once a tool round has ended, just
+ * before the next request, the runtime hands it to the model inside that same turn (after the round's
+ * tool results), as claude does with a message typed while it works. This frame goes out once the
+ * folded inputs are persisted, before the next request's frames. An interrupt (or another stop) that
+ * lands before the fold leaves the inputs pending; they then run as their own turns.
+ *
+ * THE CONTRACT: `count` of the host's EARLIEST sent inputs that had not yet started a turn were absorbed
+ * into the running turn, and none of them will ever produce a `result` of its own -- the running turn's
+ * one `result` covers them. An input still waiting when a turn ends is not folded: it starts its own
+ * turn, with its own `result`, in the order sent. Only the top-level session folds; a subagent never
+ * does. `Query.clearQueuedInput()` drops the inputs still waiting.
+ */
+export interface SDKHostInputFoldedMessage {
+    type: "system";
+    subtype: "host_input_folded";
+    count: number;
+    uuid: string;
+    session_id: string;
+}
 /**
  * WS-23: claude 2.1.282's `SDKInformationalMessage` -- "generic text banner emitted by the loop --
  * non-error status lines, hook feedback (e.g. a UserPromptSubmit hook's block reason)". Winter had no
@@ -678,7 +700,7 @@ export type SdkMessage = {
      */
     agents?: string[];
     [k: string]: unknown;
-} | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPermissionDeniedMessage | SDKStatusMessage | SDKCompactBoundaryMessage | SDKSessionStateChangedMessage | SDKInformationalMessage | BackgroundTaskMessage | SDKPartialAssistantMessage | SDKAPIRetryMessage | SDKRateLimitEvent | SDKAuthStatusMessage | SDKThinkingTokensMessage | SDKModelRefusalFallbackMessage | SDKModelRefusalNoFallbackMessage | SDKReasoningSummaryMessage | SDKModelSwitchMessage | SDKContinuityWarningMessage | {
+} | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPermissionDeniedMessage | SDKStatusMessage | SDKCompactBoundaryMessage | SDKSessionStateChangedMessage | SDKInformationalMessage | SDKHostInputFoldedMessage | BackgroundTaskMessage | SDKPartialAssistantMessage | SDKAPIRetryMessage | SDKRateLimitEvent | SDKAuthStatusMessage | SDKThinkingTokensMessage | SDKModelRefusalFallbackMessage | SDKModelRefusalNoFallbackMessage | SDKReasoningSummaryMessage | SDKModelSwitchMessage | SDKContinuityWarningMessage | {
     type: "assistant";
     message: {
         content: Array<{

package/dist/query.d.ts

@@ -159,6 +159,24 @@ export interface Query extends AsyncGenerator<SdkMessage> {
      * type-checking); every `Query` this package returns has it.
      */
     reconnectMcpServer?(serverName: string): Promise<void>;
+    /**
+     * WINTER-ONLY, additive: drop every input this query sent that is still WAITING -- it has neither
+     * started a turn nor been folded into the running one (`system/host_input_folded`) -- and resolve with
+     * how many were dropped. A dropped input never runs and never gets a `result`. Nothing else changes:
+     * the running turn keeps running, and queued task notifications stay queued. An item the prompt
+     * iterable has not yielded yet has not been sent, so it is not touched.
+     *
+     * Rides Winter's own `clear_queued_input` control subtype. claude can cancel one queued input by id;
+     * this clears them all. A runtime older than this control answers `unknown_subtype`, and the promise
+     * REJECTS with a `WinterRpcError` carrying that code -- a host that may drive an older runtime must
+     * catch it (nothing was cleared).
+     *
+     * OPTIONAL on the interface for the same reason as `compact` (a host's structural `Query` doubles keep
+     * type-checking); every `Query` this package returns has it.
+     */
+    clearQueuedInput?(): Promise<{
+        cleared: number;
+    }>;
     /**
      * Phase 6 Task 10 (derived-shapes-p6 item (d), `sdk.d.ts:2566`): the models this session may select.
      *

package/package.json

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