@canonmsg/agent-sdk 12.1.0 → 12.2.0

package/dist/internal/core/types.d.ts

@@ -141,25 +141,6 @@ export interface CanonConversation {
     activeCall?: CanonActiveCallSummary | null;
     createdAt: string;
 }
-/** Opt-in paging for `GET /conversations`. Omit both fields for the full list. */
-export interface CanonConversationsPageOptions {
-    /** Page size, 1..100 (server default 50 when the parameter is present). */
-    limit?: number;
-    /** Cursor from a previous page's `nextBefore`. */
-    before?: string;
-}
-/**
- * One page of conversations. Pages are cut in conversation-id order (stable
- * under live traffic); each page's array is still sorted most-recent-first
- * *within the page*, so concatenating pages is not globally recency-sorted.
- * `nextBefore` is null when the sweep is exhausted — a short page is not a
- * reliable end signal, because hidden conversations are filtered after the
- * page is read.
- */
-export interface CanonConversationsPage {
-    conversations: CanonConversation[];
-    nextBefore: string | null;
-}
 export interface CanonMessagesPage {
     messages: CanonMessage[];
     nextBefore?: string | null;
@@ -185,34 +166,9 @@ export interface CanonRuntimeProvenance {
         type?: CanonSelfContext['type'] | string | null;
     } | null;
 }
-/**
- * Outcome of `CanonClient.addMember` / `agent.addMember`. The REST endpoint
- * returns 201 on immediate add and 202 when a group invite is waiting for
- * policy approval.
- * Both are success from the protocol's perspective — distinct outcomes for
- * the caller.
- */
-export type AddMemberResult = {
-    status: 'added';
-} | {
-    status: 'pending';
-    requestId: string;
-};
 export type ContactSource = 'direct_add' | 'phone_book' | 'contact_request' | 'link' | 'qr' | 'group' | 'open_inbound_message'
 /** Sentinel value emitted by stream-service when a doc lacks a source field. */
  | 'unknown';
-/** A single entry from the agent's `users/{agentId}/contacts/` subcollection. */
-export interface CanonContact {
-    /** The contact's userId. */
-    id: string;
-    source: ContactSource;
-    addedAt: string | null;
-    displayNameOverride: string | null;
-}
-export type ContactAddedPayload = CanonContact;
-export type ContactRemovedPayload = {
-    id: string;
-};
 export type ResolvedAdmissionState = 'self' | 'not-found' | 'allowed' | 'request-required' | 'pending-outbound' | 'blocked' | 'inactive';
 export interface ResolvedAdmissionTargetSummary {
     id: string;
@@ -236,13 +192,6 @@ export interface ResolvedTargetAdmissionPayload {
     blockedByViewer?: boolean;
     blockedByTarget?: boolean;
 }
-export type ResolveAdmissionTargetInput = {
-    targetUserId: string;
-    canonContactId?: never;
-} | {
-    canonContactId: string;
-    targetUserId?: never;
-};
 export interface CanonResolveAdmissionResult {
     resolvedTargetUserId?: string | null;
     target: ResolvedAdmissionTargetSummary | null;
@@ -591,29 +540,6 @@ export interface MessageCreatedPayload {
         contactCard?: ContactCardPayload;
     };
 }
-export interface MessageUpdatedPayload {
-    conversationId: string;
-    messageId: string;
-    actorId?: string;
-    updatedAt?: string;
-    changes: {
-        reactions?: Record<string, string[]>;
-        /** Canonical ready attachments after asynchronous media processing. */
-        attachments?: MediaAttachment[];
-        [key: string]: unknown;
-    };
-}
-export interface TypingPayload {
-    conversationId: string;
-    userId: string;
-    isTyping: boolean;
-    status?: 'thinking' | 'typing';
-    timestamp?: number;
-}
-export interface PresencePayload {
-    userId: string;
-    online: boolean;
-}
 export interface RuntimeUpdatedPayload {
     conversationId: string;
     agentId: string;
@@ -621,61 +547,6 @@ export interface RuntimeUpdatedPayload {
     runtimeInfo?: RuntimeInfoPayload | null;
     agentSession: AgentSessionSnapshot | null;
 }
-export interface TurnUpdatedPayload {
-    conversationId: string;
-    agentId: string;
-    turn: import('./turn-protocol.js').TurnState | null;
-}
-/**
- * Observe-only notice that the participation gate suppressed a turn this
- * agent would otherwise have been dispatched (cap reached, mention required,
- * agent-to-agent disabled). Hosts must not run a turn off this event; it
- * exists so a benched agent can tell deliberate policy from a dead stream.
- */
-export interface ParticipationSuppressedPayload {
-    conversationId: string;
-    /** The triggering message whose dispatch was suppressed. */
-    messageId: string;
-    /** Machine code, e.g. 'agent_turn_limit_reached' | 'group_mention_required'. */
-    reasonCode: string;
-    /** Human-readable form of the same reason. */
-    reason: string;
-    /** ISO timestamp stamped by stream-service at suppression time. */
-    suppressedAt: string;
-}
-export type RuntimeControlEventKind = 'interaction_response' | 'session' | 'signal' | 'primitive' | 'runtimeInput' | 'runtimeCard' | 'runtimeApproval';
-export interface RuntimeControlEventPayload {
-    conversationId: string;
-    agentId: string;
-    kind: RuntimeControlEventKind;
-    requestId?: string;
-    updatedAt?: number;
-    value: Record<string, unknown>;
-    /** Conversation-scoped reply capability for an accepted interaction receipt. */
-    replyAuthority?: import('../backend-contracts/index.js').AgentReplyAuthorityV1;
-}
-export interface CanonMembershipChange {
-    addedMemberIds: string[];
-    removedMemberIds: string[];
-    memberCount: number;
-}
-export interface ConversationUpdatedPayload {
-    conversationId: string;
-    changes: Record<string, unknown>;
-    membershipChange?: CanonMembershipChange;
-}
-export interface VoiceSessionEventPayload {
-    conversationId: string;
-    session: CanonVoiceSession;
-    /**
-     * True when this call targets the receiving agent (runtime_voice aimed at
-     * it). Voice events are conversation-scoped — group and human-mode calls
-     * arrive with targetsMe false; never auto-join on a bare 'started'.
-     * Absent on streams older than the media/video rollout: treat as targeted
-     * (the legacy filter only delivered targeted sessions).
-     */
-    targetsMe?: boolean;
-}
 export interface SendMessageOptions {
     messageId?: string;
     contentType?: 'text' | 'audio' | 'image' | 'video' | 'file' | 'contact_card';
@@ -692,13 +563,6 @@ export interface SendMessageOptions {
     /** Trusted transport context injected by the host, never by the model. */
     replyAuthority?: import('../backend-contracts/index.js').AgentReplyAuthorityV1;
 }
-export interface CreateGroupOptions {
-    memberIds: string[];
-    name: string;
-}
-export interface CreateGroupResult {
-    conversationId: string;
-}
 export type CanonVoiceSessionMode = 'human' | 'runtime_voice';
 export type CanonVoiceSessionStatus = 'active' | 'ended' | 'error';
 /** Call media. Absent anywhere in the wire always means 'audio'. */
@@ -746,51 +610,6 @@ export interface CanonVoiceSessionToken {
     targetAgentId?: string | null;
     expiresAt: string;
 }
-export interface CreateVoiceSessionOptions {
-    conversationId: string;
-    targetAgentId?: string | null;
-    /** Requested call media; the server defaults absent/unknown to 'audio'. */
-    media?: CanonVoiceSessionMedia;
-}
-export interface CreateMemoStreamOptions {
-    conversationId: string;
-    /** v1 accepts 'wav' only (byte-append decodable and seekable everywhere). */
-    container: 'wav';
-    codec: {
-        mimeType: string;
-        sampleRate: number;
-        channels: number;
-        bitsPerSample: number;
-    };
-    /** Byte offset of PCM data in the sender's file (RIFF headers precede it). */
-    dataOffset?: number;
-    /** Pre-allocated durable message id, for the live→durable timeline handoff. */
-    messageId?: string | null;
-}
-export interface CreateMemoStreamResult {
-    streamId: string;
-    bucket: string;
-}
-export interface AppendMemoStreamChunkOptions {
-    /** Zero-based, strictly sequential. Retries of the last chunk are acked. */
-    seq: number;
-    /** Base64 chunk bytes; may be empty when only carrying the final marker. */
-    data: string;
-    /** Normalized 0..1 amplitude bars for live waveforms. */
-    peaks?: number[];
-    /** Running duration of the recording in milliseconds. */
-    durationMs?: number;
-    /** Marks the recording finished; the stream leaves the live window. */
-    final?: boolean;
-}
-export interface MemoStreamChunkAck {
-    chunkCount: number;
-    totalBytes: number;
-    applied: boolean;
-}
-export interface JoinVoiceSessionOptions {
-    conversationId: string;
-}
 export type StreamingStatus = 'thinking' | 'streaming' | 'tool' | 'waiting_input';
 export interface SetStreamingOptions {
     conversationId: string;

package/dist/media.js

@@ -18,8 +18,8 @@ import {
   toAnthropicImageBlock,
   toAnthropicImageBlocksWithinBudget,
   uploadMediaFile
-} from "./chunks/chunk-QZ4PPRQW.js";
-import "./chunks/chunk-7N6OPPW4.js";
+} from "./chunks/chunk-O5C3ZGI4.js";
+import "./chunks/chunk-J63YVAKA.js";
 export {
   DEFAULT_ANTHROPIC_REQUEST_HEADROOM_BYTES,
   DEFAULT_MEDIA_CACHE_DIR,

package/dist/runner/types.d.ts

@@ -5,7 +5,7 @@ import type { MediaAttachment } from '../internal/core/index.js';
  * the claude and codex drivers pass the conformance suite.
  */
 export interface RuntimeDriver {
-    readonly name: 'code' | 'claude' | 'codex' | 'hermes' | 'connector';
+    readonly name: 'code' | 'claude' | 'codex' | 'connector';
     /** Input to the generated runtime descriptor; never a static table. */
     readonly capabilities: DriverCapabilities;
     runTurn(turn: DriverTurn): Promise<DriverResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "12.1.0",
+  "version": "12.2.0",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",

package/dist/internal/core/stream.d.ts

@@ -1,78 +0,0 @@
-import type { CanonEndpoint } from './endpoint-client.js';
-import type { AgentContext, ContactAddedPayload, ContactRemovedPayload, ConversationUpdatedPayload, MessageCreatedPayload, MessageUpdatedPayload, TypingPayload, PresencePayload, RuntimeUpdatedPayload, RuntimeControlEventPayload, TurnUpdatedPayload, ParticipationSuppressedPayload, VoiceSessionEventPayload } from './types.js';
-export interface CanonStreamErrorPayload {
-    code?: string;
-    message?: string;
-    retryAfterMs?: number;
-    activeConnections?: number;
-    maxConnections?: number;
-    [key: string]: unknown;
-}
-export interface ReplayExpiredPayload {
-    /** Oldest event id still available in the server's replay buffer, if any. */
-    lastAvailableId?: string | null;
-    message?: string;
-    [key: string]: unknown;
-}
-export declare class CanonStreamError extends Error {
-    readonly code?: string;
-    readonly retryAfterMs?: number;
-    readonly payload: CanonStreamErrorPayload;
-    constructor(payload: CanonStreamErrorPayload, fallbackMessage: string);
-}
-export type StreamHandler = {
-    onMessage: (payload: MessageCreatedPayload) => void;
-    onMessageUpdated?: (payload: MessageUpdatedPayload) => void;
-    onAgentContext?: (ctx: AgentContext) => void;
-    onContactAdded?: (payload: ContactAddedPayload) => void;
-    onContactRemoved?: (payload: ContactRemovedPayload) => void;
-    onTyping?: (data: TypingPayload) => void;
-    onPresence?: (data: PresencePayload) => void;
-    onRuntimeUpdated?: (payload: RuntimeUpdatedPayload) => void;
-    onTurnUpdated?: (payload: TurnUpdatedPayload) => void;
-    /** Observe-only: the participation gate suppressed a turn for this agent. */
-    onParticipationSuppressed?: (payload: ParticipationSuppressedPayload) => void;
-    onRuntimeControl?: (payload: RuntimeControlEventPayload) => void;
-    onVoiceSessionStarted?: (payload: VoiceSessionEventPayload) => void;
-    onVoiceSessionEnded?: (payload: VoiceSessionEventPayload) => void;
-    onMessageDeleted?: (payload: {
-        conversationId: string;
-        messageId: string;
-    }) => void;
-    onConversationUpdated?: (payload: ConversationUpdatedPayload) => void;
-    onConnected?: () => void;
-    onDisconnected?: () => void;
-    /**
-     * Fired when the server reports the replay window expired (`replay.expired`):
-     * the reconnect cursor was evicted, so events in the gap were NOT replayed
-     * and must be recovered out-of-band (e.g. via the REST API). The transport
-     * stays policy-free — it only clears its cursor and surfaces the expiry.
-     *
-     * When this handler is provided it REPLACES the synthetic
-     * `Replay expired — some messages may have been missed` error on `onError`;
-     * raw consumers that only register `onError` keep the existing behavior.
-     */
-    onReplayExpired?: (payload: ReplayExpiredPayload) => void;
-    /** `conversationId` names the room when endpoint recovery failed for one. */
-    onError?: (error: Error, conversationId?: string) => void;
-};
-/** Typed agent event projection; the endpoint owns authentication, SSE and reconnect. */
-export declare class CanonStream {
-    private readonly endpoint;
-    private readonly agentId;
-    private readonly handler;
-    private unsubscribe?;
-    private releaseRecovery?;
-    private running;
-    private generation;
-    private resolveStopped?;
-    constructor(options: {
-        endpoint: CanonEndpoint;
-        agentId: string;
-        handler: StreamHandler;
-    });
-    start(): Promise<void>;
-    private forwardPlaintextMessage;
-    stop(): void;
-    isRunning(): boolean;
-}