@yanlinglabs/winter-agent-sdk 0.0.2 → 0.0.4

package/README.md

@@ -38,6 +38,36 @@ files, `README.md` and `LICENSE`. It does **not** ship `src/`: the TypeScript so
 <https://github.com/yanlingLabs/winter-agent-sdk>, which is where to read them, file an issue, or send
 a patch.
 
+## Subpaths
+
+The main entry is the wrapper surface above. Two subpaths ship beside it, for hosts that compose
+Winter rather than only call it:
+
+**`@yanlinglabs/winter-agent-sdk/messaging`** (since 0.0.2) — the cross-runtime messaging contract
+and its router core: addresses, listings, delivery outcomes, the adapter interface, inbound policy,
+the `notify_when_idle` subscription store, and the three orchestration functions a host drives them
+with. It ships no adapter and no process-level singleton; those are host composition.
+
+**`@yanlinglabs/winter-agent-sdk/tools`** (since 0.0.3) — Winter's default tools, declared and
+implemented once:
+
+- `WINTER_DEFAULT_TOOL_DEFINITIONS` — `send_message`, `list_agents`, `read_notifications` and
+  `advisor`, each a `WinterToolDefinition` carrying a BARE `toolName`, the official built-in alias
+  key in `builtinName`, the description, the schemas and a permission class. No registry policy
+  fields: a host supplies its own.
+- the native schemas and their bounds (`NATIVE_SEND_MESSAGE_SCHEMA`, `SEND_MESSAGE_TO_MAX` and the
+  rest), plus strict acceptors — unknown arguments are refused, `summary` is truncated rather than
+  rejected, and a refusal is returned as data the model can correct from, never thrown.
+- `MessagingToolPort` + `messagingToolPortFromRuntimeDeps`, and `createMessagingToolHandlers`, which
+  turn a messaging world into the three tool handlers over it.
+- `createAdvisorToolHandler` and `transcriptSourceForSessionKey`, with the reviewer left to the host
+  to resolve.
+
+A host BINDS these under its own names: the Winter runtime registers them as its native built-ins
+plus two canonical standing-server twins, and `@yanlinglabs/winter-runtime-sdk` binds the same
+definitions under Claude's built-in names. Handlers return `{ text, isError? }` for each host to
+wrap in its own result shape.
+
 ## License
 
 MIT — see [`LICENSE`](./LICENSE), which ships in the published tarball.

package/dist/{index-h1tryj38.js → index-51ysrfm8.js}

@@ -611,4 +611,4 @@ function createMessagingRouter2(deps) {
     readNotifications: (caller) => readNotifications2(deps, caller)
   };
 }
-export { serializeRuntimeAddress2, createFakeMessagingRouterSeam2, REFERENCE_RUNTIME_KIND2, validateToField2, buildSessionAddress2, buildChildAddress2, parseRuntimeAddress2, sameAddress2, MAX_GLOBAL_MESSAGE_SIZE2, DEFAULT_MESSAGE_TTL_MS2, MAX_HOP_COUNT2, RAPID_REPEAT_WINDOW_MS2, HELD_INBOX_CAP2, ACCEPTED_QUEUE_CAP2, DEFAULT_HOLD_EXPIRY_MS2, NOTIFY_IDLE_EXPIRY_MS2, messageExceedsMaxSize2, hopCountExceeded2, delivered2, queued2, resumedAndDelivered2, held2, subscribed2, deliveryUncertain2, refused2, ambiguous2, notFound2, unavailable2, createLoopGuard2, childToListedRuntimeObject2, resolveTarget2, classifyPermissionMode2, mapFromModeToPermissionClass2, defaultInboundResult2, resolveInboundDecision2, createMailbox2, buildDefaultHoldEntry2, buildExplicitHoldEntry2, isIdleSubscribeSenderAllowed2, isIdleSubscribeTargetAllowed2, createNotificationQueue2, createIdleSubscriptionStore2, AGENT_MESSAGE_TAG2, escapeAttributionText2, escapeAttributionAttribute2, RESERVED_NOTIFICATION_KEY_PREFIX2, facetNotificationKey2, isReservedNotificationKey2, MAX_TRACKED_MESSAGE_IDS2, rememberBounded2, createMessagingRouterSeam2, createSubscriberDirectory2, callerAddress2, sendMessage2, listAgents2, readNotifications2, createMessagingRouter2 };
+export { serializeRuntimeAddress2, createFakeMessagingRouterSeam2, REFERENCE_RUNTIME_KIND2, validateToField2, buildSessionAddress2, buildChildAddress2, parseRuntimeAddress2, sameAddress2, MAX_GLOBAL_MESSAGE_SIZE2, DEFAULT_MESSAGE_TTL_MS2, MAX_HOP_COUNT2, RAPID_REPEAT_WINDOW_MS2, HELD_INBOX_CAP2, ACCEPTED_QUEUE_CAP2, DEFAULT_HOLD_EXPIRY_MS2, NOTIFY_IDLE_EXPIRY_MS2, messageExceedsMaxSize2, hopCountExceeded2, delivered2, queued2, resumedAndDelivered2, held2, subscribed2, deliveryUncertain2, refused2, ambiguous2, notFound2, unavailable2, createLoopGuard2, childToListedRuntimeObject2, resolveTarget2, classifyPermissionMode2, mapFromModeToPermissionClass2, defaultInboundResult2, resolveInboundDecision2, createMailbox2, buildDefaultHoldEntry2, buildExplicitHoldEntry2, isIdleSubscribeSenderAllowed2, isIdleSubscribeTargetAllowed2, createNotificationQueue2, createIdleSubscriptionStore2, AGENT_MESSAGE_TAG2, escapeAttributionText2, escapeAttributionAttribute2, RESERVED_NOTIFICATION_KEY_PREFIX2, facetNotificationKey2, isReservedNotificationKey2, MAX_TRACKED_MESSAGE_IDS2, rememberBounded2, createMessagingRouterSeam2, createSubscriberDirectory2, callerAddress2, sendMessage2, formatListing, listAgents2, readNotifications2, createMessagingRouter2 };