@yanlinglabs/winter-agent-sdk 0.0.13 → 0.0.15

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export type { QueryInternal, ControlRequestHandler, ControlRequestHandlerResult
 export type { Options } from "./options.js";
 export { SYSTEM_PROMPT_DYNAMIC_BOUNDARY, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_COMPACTION_THRESHOLD, DEFAULT_PLANS_DIRECTORY, DEFAULT_OUTPUT_STYLE } from "./options.js";
 export { DEFAULT_PROVIDER_STALL_TIMEOUT_MS, DEFAULT_KEYCHAIN_SERVICE } from "./options.js";
-export type { ProviderSelection, ProviderConnectionConfig, CredentialRef, ThinkingConfig, EffortLevel, AutoClassifierConfig, AdvisorConfig, ModelInfo, AccountInfo } from "./protocol/config.js";
+export type { ProviderSelection, ProviderConnectionConfig, CredentialRef, ThinkingConfig, EffortLevel, AutoClassifierConfig, AdvisorConfig, ModelInfo, AgentInfo, AccountInfo } from "./protocol/config.js";
 export type { SlotView, ActiveSlotSet, ModelFamilyListing, ModelSlotSetting, ModelRowServable } from "./protocol/config.js";
 export type { SdkPluginConfig, SystemPromptOption, SystemPromptPreset, OutputFormat, JsonSchemaOutputFormat, SkillsOption, RewindFilesResult, RewindFilesRequest, InitPluginInfo } from "./protocol/config.js";
 export type { McpServerConfig, McpSdkServerConfigWithInstance, McpServerToolPolicy, McpStdioServerConfig, McpHttpServerConfig, McpSSEServerConfig, McpSdkServerConfig, AgentDefinition } from "./options.js";

package/dist/index.js

@@ -578,6 +578,7 @@ function query(args) {
     ...options.toolAliases !== undefined ? { toolAliases: options.toolAliases } : {},
     ...options.agents !== undefined ? { agents: options.agents } : {},
     ...options.forwardSubagentText !== undefined ? { forwardSubagentText: options.forwardSubagentText } : {},
+    ...options.forkSubagent !== undefined ? { forkSubagent: options.forkSubagent } : {},
     ...options.systemPrompt !== undefined ? { systemPrompt: options.systemPrompt } : {},
     ...options.plugins !== undefined ? { plugins: options.plugins } : {},
     ...options.skills !== undefined ? { skills: options.skills } : {},
@@ -850,6 +851,10 @@ function query(args) {
     const payload = await sendControlRequest("list_models", undefined);
     return Array.isArray(payload) ? payload : [];
   };
+  gen.supportedAgents = async () => {
+    const payload = await sendControlRequest("list_agents", undefined);
+    return Array.isArray(payload) ? payload : [];
+  };
   gen.listModelFamilies = async () => {
     const payload = await sendControlRequest("list_model_families", undefined);
     return isModelFamilyListing(payload) ? payload : { active: undefined, families: [] };
@@ -961,7 +966,7 @@ function query(args) {
   return gen;
 }
 // src/version.ts
-var SDK_VERSION = "0.0.13";
+var SDK_VERSION = "0.0.15";
 // 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/options.d.ts

@@ -97,6 +97,12 @@ export interface Options {
     toolAliases?: Record<string, string>;
     agents?: Record<string, AgentDefinition>;
     forwardSubagentText?: boolean;
+    /**
+     * Winter extension (spawn-surface parity R-S5): enables `subagent_type: "fork"` for this session.
+     * `true` on, `false` off; omitted = the runtime reads `WINTER_FORK_SUBAGENT` (claude's own
+     * `CLAUDE_CODE_FORK_SUBAGENT`), and is off when that is unset.
+     */
+    forkSubagent?: boolean;
     onElicitation?: (request: {
         serverName: string;
         message: string;

package/dist/protocol/config.d.ts

@@ -164,6 +164,39 @@ export interface RuntimeAgentDefinition {
     permissionMode?: string;
     observer?: string;
     observerMessage?: string;
+    /**
+     * A filesystem/frontmatter agent's own `isolation` (research §A1's own field table: "also color,
+     * isolation (worktree|remote), background, memory, effort, permissionMode"). Mirrors the model-
+     * facing `Agent` tool's own `isolation` enum exactly -- a DEFINITION may pin the isolation a caller
+     * would otherwise choose per-invocation. Absent = no isolation preference from the definition
+     * (today: the invocation's own `isolation` field, if any, still governs -- wiring a definition's
+     * own value through spawn resolution is a later lane's job; this field only carries it now).
+     */
+    isolation?: "worktree" | "remote";
+    /**
+     * A filesystem/frontmatter agent's own display `color` (research §A1's field table, same entry as
+     * `isolation` above). Advisory/presentational only -- nothing in this package interprets it; a host
+     * UI (or a future Winter surface) may render an agent's rows in its own color.
+     */
+    color?: string;
+    /**
+     * The `claude` built-in's own shape (research §A1: "`appendSystemPrompt: true` (appended to the
+     * default prompt)"): when true, `prompt` is APPENDED to the session's own composed system prompt
+     * rather than replacing it the way every other definition's `prompt` does (WS-10 §2's "system
+     * prompt of the child", layered onto the base). Absent/false = the established replace-and-layer
+     * behavior every pre-existing definition already has.
+     */
+    appendSystemPrompt?: boolean;
+    /**
+     * The `Explore`/`Plan` built-ins' own shape (research §A1: "`omitClaudeMd: true`; context also
+     * drops gitStatus"). WINTER-NAMED rather than mirroring the pinned field's own product-specific
+     * spelling (WS-01 §5's own "rebrand, don't borrow the vendor's literal name" posture) -- but the
+     * BEHAVIOR is identical: when true, this agent's own context assembly omits the discovered
+     * project-instructions file (the brand's own instructions-file convention, `brand.instructionsFile`) and the git-status dynamic section
+     * from its system/user-context, the same two things claude's `omitClaudeMd` drops. Absent/false =
+     * every pre-existing definition's context, unchanged.
+     */
+    omitProjectContext?: boolean;
 }
 export interface RuntimeConfig {
     sessionId: string;
@@ -209,6 +242,18 @@ export interface RuntimeConfig {
     forwardSubagentText?: boolean;
     agentId?: string;
     isolationPinnedCwd?: boolean;
+    /**
+     * Spawn-surface parity (R-S5): the fork gate -- `subagent_type: "fork"` is selectable (and the
+     * `fork` built-in is listed) only when this is `true`. `false` forces it off; ABSENT falls back to
+     * the `<PREFIX>FORK_SUBAGENT` env var (claude's own `CLAUDE_CODE_FORK_SUBAGENT` precedent), and
+     * absent-and-unset is OFF (a Winter session is non-interactive, like a headless SDK session).
+     */
+    forkSubagent?: boolean;
+    /**
+     * Spawn-surface parity (R-S5): set ONLY on the RuntimeConfig of a child that is itself a FORK --
+     * a forked worker may not fork again (claude's own refusal). Never set by `query()`.
+     */
+    insideFork?: boolean;
     systemPrompt?: SystemPromptOption;
     plugins?: SdkPluginConfig[];
     skills?: SkillsOption;
@@ -422,6 +467,21 @@ export interface ModelInfo {
     supportsFastMode?: boolean;
     supportsAutoMode?: boolean;
 }
+/**
+ * The pinned `AgentInfo` (0.3.250 `sdk.d.ts`: "Information about an available subagent that can be
+ * invoked via the Task/Agent tool"). Three fields, one required trio short of `ModelInfo`'s own
+ * richness -- `name`/`description` required, `model` optional ("Model alias this agent uses. If
+ * omitted, inherits the parent's model").
+ *
+ * Declared here for the identical structural reason `ModelInfo`/`AccountInfo` are: `Query.
+ * supportedAgents()` is on the sdk's public surface, the sdk package is dependency-free and
+ * fence-resident, and `packages/runtime` (which BUILDS the listing this feeds) is Bun-only.
+ */
+export interface AgentInfo {
+    name: string;
+    description: string;
+    model?: string;
+}
 /**
  * The pinned `AccountInfo` (`sdk.d.ts:23-33`). EVERY field optional; an empty object is valid, and
  * capture (J) observed exactly three keys present under API-key auth.

package/dist/protocol/frames.d.ts

@@ -245,6 +245,7 @@ export type WireContentBlock = {
     type: "tool_result";
     tool_use_id: string;
     content: string | WireContentBlock[];
+    is_error?: boolean;
     [k: string]: unknown;
 } | {
     type: "image";
@@ -557,6 +558,15 @@ export type SdkMessage = {
     skills: string[];
     plugins: InitPluginInfo[];
     mcp_servers?: WireMcpServerStatus[];
+    /**
+     * Spawn-surface parity (research §A3): the per-session `subagent_type` names -- the SAME set
+     * `Query.supportedAgents()` reports (research: "Same list feeds `system/init.agents?:
+     * string[]` and `Query.supportedAgents(): AgentInfo[]`"). Present only when the `Agent` tool
+     * is itself advertised (absent otherwise, matching `mcp_servers`' own conditional-presence
+     * convention on this same frame) -- the engine-side producer is `engine.ts`'s own
+     * `system/init` block.
+     */
+    agents?: string[];
     [k: string]: unknown;
 } | SDKHookStartedMessage | SDKHookProgressMessage | SDKHookResponseMessage | SDKPermissionDeniedMessage | SDKStatusMessage | SDKCompactBoundaryMessage | BackgroundTaskMessage | SDKPartialAssistantMessage | SDKAPIRetryMessage | SDKRateLimitEvent | SDKAuthStatusMessage | SDKThinkingTokensMessage | SDKModelRefusalFallbackMessage | SDKModelRefusalNoFallbackMessage | SDKReasoningSummaryMessage | SDKModelSwitchMessage | SDKContinuityWarningMessage | {
     type: "assistant";

package/dist/query.d.ts

@@ -1,5 +1,5 @@
 import type { SdkMessage as RuntimeSdkMessage } from "./protocol/frames.js";
-import type { AccountInfo, ModelInfo, ModelFamilyListing, RewindFilesResult } from "./protocol/config.js";
+import type { AccountInfo, AgentInfo, ModelInfo, ModelFamilyListing, RewindFilesResult } from "./protocol/config.js";
 import { type Options } from "./options.js";
 import type { PermissionMode, PermissionResult } from "./permissions/types.js";
 import { type DeliveryOutcome, type GlobalAgentMessage, type ListedRuntimeObject, type PermissionClassLabel } from "./messaging/index.js";
@@ -120,6 +120,20 @@ export interface Query extends AsyncGenerator<SdkMessage> {
      * so the answer is a table lookup rather than a network round trip.
      */
     supportedModels(): Promise<ModelInfo[]>;
+    /**
+     * Spawn-surface parity (0.3.250 `sdk.d.ts:2572`, pinned): "Get the list of available subagents for
+     * the current session" — the SAME per-session agent-type list `system/init.agents` carries (research
+     * §A3: "Same list feeds `system/init.agents?: string[]` and `Query.supportedAgents(): AgentInfo[]`"),
+     * here as the richer `{name, description, model?}` triple rather than bare names. A BARE ARRAY, same
+     * shape as `supportedModels` above — served from the runtime's own resolved built-in/filesystem/
+     * programmatic agent set, a table lookup rather than a network round trip.
+     *
+     * The control-subtype producer (the runtime's `list_agents` handler) is a separate lane's wiring;
+     * this wrapper degrades a malformed/absent payload to `[]`, matching `supportedModels`'/
+     * `listModelFamilies`' own "answers with data, never leaves a rejection standing in for absence"
+     * posture.
+     */
+    supportedAgents(): Promise<AgentInfo[]>;
     /**
      * WS-13c §7 (P6.6 Lane C) — WINTER-ONLY, no pinned counterpart: the active slot set this session is
      * currently offering, plus every model family behind "more options". A model switcher shows

package/package.json

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