@canonmsg/agent-sdk 5.1.2 → 5.1.4

package/README.md

@@ -47,7 +47,7 @@ No additional dependencies required — the SDK uses native `fetch` and `Readabl
 | `runtimeControls` | `RuntimeControlHandlers` | `undefined` | Optional interrupt / stop-clear handlers for Canon working-state controls |
 | `runtimeControlSurface` | `'agent' \| 'host'` | `'agent'` | Runtime publishing surface. Use `host` when this SDK agent owns live runtime controls. |
 | `runtimePrimitives` | `RuntimePrimitiveHandlers` | `undefined` | Optional typed primitive command handlers for descriptor-backed runtime commands |
-| `sessionState` | `boolean` | `false` | Publish RTDB session-state for the conversations this agent is active in |
+| `sessionState` | `boolean` | `false` | Publish runtime-applied state to the canonical agent-session snapshot |
 
 ### Optional runtime controls
 

package/dist/canon-agent.js

@@ -1,4 +1,4 @@
-import { ApprovalManager, RuntimeRequestManager, runtimeInputDescriptor, runtimeCardDescriptor, CanonClient, ControlChannelPoller, buildCanonTurnContextV2, buildCanonGroupContext, buildParticipationHistorySnapshot, createTurnOutputController, createRuntimeStatePublisher, createTypingStatusPublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeCardOutcome, buildRuntimeInputOutcome, initRTDBAuth, normalizeRuntimeCommandDescriptors, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, renderCanonHostInboundContent, sendMessageWithRetry, } from '@canonmsg/core';
+import { ApprovalManager, RuntimeRequestManager, runtimeInputDescriptor, runtimeCardDescriptor, CanonClient, DEFAULT_BASE_URL, ControlChannelPoller, buildCanonTurnContextV2, buildCanonGroupContext, buildParticipationHistorySnapshot, createTurnOutputController, createRuntimeStatePublisher, createTypingStatusPublisher, diffCanonMemberIds, FINAL_MESSAGE_HANDOFF_MS, RUNTIME_NEW_SESSION_ACTION, RUNTIME_STOP_ACTION, RUNTIME_STOP_AND_DROP_ACTION, buildRuntimeCardOutcome, buildRuntimeInputOutcome, initRTDBAuth, normalizeRuntimeCommandDescriptors, normalizeTurnMetadata, reachOutToCanonContact, resolveCanonReplyContext, resolveMessageActiveSelfContextId, resolveRuntimeProvenance, selectActiveSelfContexts, renderCanonHostInboundContent, sendMessageWithRetry, } from '@canonmsg/core';
 import { createHash, randomUUID } from 'node:crypto';
 import { AuthManager } from './auth.js';
 import { Debouncer } from './debouncer.js';
@@ -292,7 +292,7 @@ export class CanonAgent {
     sseConnectedLogged = false;
     constructor(options) {
         this.options = {
-            baseUrl: 'https://api-6m6mlelskq-uc.a.run.app',
+            baseUrl: DEFAULT_BASE_URL,
             deliveryMode: 'auto',
             debounceMs: 2000,
             historyLimit: 50,

package/dist/types.d.ts

@@ -270,7 +270,7 @@ export interface CanonAgentOptions {
     /** Optional typed runtime primitive handlers. Enables descriptor-backed command controls when provided. */
     runtimePrimitives?: RuntimePrimitiveHandlers;
     /**
-     * Enable RTDB session-state reporting. Off by default.
+     * Enable canonical agent-session state reporting. Off by default.
      * Turn-state reporting is automatic while handlers run.
      */
     sessionState?: boolean;
@@ -313,7 +313,12 @@ export type ReachOutResult = {
     reason: string;
 };
 export interface ReachOutOptions {
-    /** Optional first message to send when admission is `allowed`. */
+    /**
+     * Optional first message; sent now when allowed or parked for exact delivery
+     * after approval when it is visible text <= 4 KiB. Attachments and hidden
+     * session setup cannot be parked; a setup-requiring coding target returns
+     * `setup_required` before a contact request is created.
+     */
     text?: string;
     /** Optional contact-request note. Defaults to `text` when admission is `request-required`. */
     requestMessage?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "5.1.2",
+  "version": "5.1.4",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@canonmsg/core": "^4.3.0"
+    "@canonmsg/core": "^5.0.1"
   },
   "publishConfig": {
     "access": "public"