@canonmsg/agent-sdk 13.1.0 → 13.2.1

package/dist/mls-wasm-host.js

@@ -2,20 +2,20 @@ import {
   WASM_HOST_CONFIGURE,
   WASM_HOST_PROVISION,
   keyFile
-} from "./chunks/chunk-DTAWEQCM.js";
+} from "./chunks/chunk-POBMFS2K.js";
 import {
   MAX_INPUT,
   NodeMlsDevCustodyError,
   parseFrame,
   rejected,
   requireValue
-} from "./chunks/chunk-YJUPKU47.js";
+} from "./chunks/chunk-BPSFHEAA.js";
 import {
   __name,
   canonicalEndpointJson,
   isMlsDevReceiptClockSkew,
   parseMlsDevDeviceContext
-} from "./chunks/chunk-5WPAB5MB.js";
+} from "./chunks/chunk-VIS5WXNH.js";
 
 // src/mls-wasm-host.ts
 import { createHash } from "node:crypto";

package/dist/runner/errands.d.ts

@@ -95,8 +95,8 @@ export declare function awaitErrand(directory: string, command: Pick<ErrandComma
     accepted: boolean;
 }>;
 export interface ErrandHandler {
-    /** The command was taken already (its record or its journaled output exists): its file is only removed. */
-    taken(id: string): boolean;
+    /** The command was taken already (its record or its saved output exists): its file is only removed. */
+    taken(id: string): boolean | Promise<boolean>;
     /**
      * The command, or why its file is refused. True once its effect (or refusal) is journaled, so the file may go; false
      * leaves it for the next scan. A throw is logged once per command and reason, and also leaves it.

package/dist/runner/runner.d.ts

@@ -102,7 +102,12 @@ export interface Runner {
     start(): Promise<void>;
     /** Stops intake, releases unsubmitted input, lets running turns finish within the shutdown grace. */
     stop(): Promise<void>;
-    /** A proactive send outside any turn (cron): the `communicate` tool's handler, under the runner's identity. */
+    /**
+     * A proactive send outside any turn (cron), under the runner's identity, with the `communicate` tool's input. Text to a
+     * conversation is encrypted for the members it has now, journaled first and sent once, even across a restart; a new
+     * conversation is founded encrypted by this device. `messageId` makes a retry the same message or start. Other actions
+     * go to Canon as they are.
+     */
     communicate(input: CommunicateInput): Promise<CommunicateResult>;
     /** What the runner has in hand now, for a host's idle policy (agent-wake.md). Only between start and stop. */
     activity(): Promise<RunnerActivity>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canonmsg/agent-sdk",
-  "version": "13.1.0",
+  "version": "13.2.1",
   "description": "Canon Agent SDK — build AI agents that participate in Canon conversations",
   "type": "module",
   "main": "dist/index.js",
@@ -31,8 +31,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@noble/curves": "2.4.0",
-    "chess.js": "1.4.0"
+    "@noble/curves": "2.4.0"
   },
   "peerDependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.289"

package/dist/internal/core/completed-output-journal.d.ts

@@ -1,34 +0,0 @@
-/**
- * A runtime's finished turn output, saved before it is published so a host that
- * dies between the native result and Canon delivery replays exactly that
- * output on restart instead of losing it, and never runs the turn again.
- */
-export interface CompletedOutputRecordBase {
-    version: 1;
-    turnId: string;
-    conversationId: string;
-    createdAt: string;
-    /** Who could read the conversation when the output was produced. */
-    audience: {
-        memberIds: string[];
-        membershipRevision?: number;
-    } | null;
-}
-export interface CompletedOutputJournal<T extends CompletedOutputRecordBase> {
-    /** Durably save a record; saving the identical record again is a no-op, a different one is refused. */
-    save(record: T): void;
-    /** Every saved record, oldest first, after recovering writes a crash interrupted. */
-    list(): T[];
-    remove(turnId: string): void;
-}
-/**
- * Atomic, fsynced, one file per turn under a folder keyed by `scope` (runtime,
- * environment, principal, ownership generation, installation), so a transferred
- * agent or another installation never sees these plaintext records.
- */
-export declare function createCompletedOutputJournal<T extends CompletedOutputRecordBase>(directory: string, scope: unknown, options: {
-    /** Names the runtime in errors, e.g. `Codex`. */
-    label: string;
-    /** Runtime-specific shape check beyond the base fields; false is an invalid record. */
-    validate?: (record: T) => boolean;
-}): CompletedOutputJournal<T>;

package/dist/internal/endpoint/artifact-images.d.ts

@@ -1,60 +0,0 @@
-import { type ArtifactImageRegion, type ArtifactImageVariant, type MediaAttachment } from '../backend-contracts/index.js';
-import type { Endpoint } from './engine.js';
-import { type ArtifactClient, type ArtifactWriteResult } from './artifacts.js';
-import { isTerminalImageGenerationError } from './image-generation-errors.js';
-export { isTerminalImageGenerationError };
-export type { ArtifactImageRegion };
-export interface ArtifactImageGenerateInput {
-    prompt: string;
-    label: string;
-    /** 'current' edits the current version (or generates new when there is none). */
-    from: 'current' | 'new' | {
-        variantId: string;
-    };
-    /** Fractions of the source image, origin top-left. */
-    region?: ArtifactImageRegion;
-    /** UUID for one deliberate generation; reuse it to collect the same result. */
-    requestId: string;
-    /** Cancels the wait. Once the job is submitted, the result is `generating` and nothing is published. */
-    signal?: AbortSignal;
-    /** How long to wait for the provider before returning `generating` (default 180 s). */
-    timeoutMs?: number;
-}
-export type ArtifactImageGenerateResult = {
-    status: 'added';
-    variant: ArtifactImageVariant;
-    result: ArtifactWriteResult;
-    attachment: MediaAttachment;
-} | {
-    status: 'generating';
-    requestId: string;
-};
-export interface ArtifactImageAddInput {
-    assetId: string;
-    label: string;
-    prompt?: string;
-    sourceVariantId?: string;
-    select?: boolean;
-}
-export interface ArtifactImageClient {
-    generate(conversationId: string, artifactId: string, input: ArtifactImageGenerateInput): Promise<ArtifactImageGenerateResult>;
-    add(conversationId: string, artifactId: string, input: ArtifactImageAddInput): Promise<{
-        variant: ArtifactImageVariant;
-        result: ArtifactWriteResult;
-    }>;
-}
-/** Test hooks; production uses the defaults. */
-export interface ArtifactImageClientOptions {
-    pollIntervalMs?: number;
-    /** A job may not be visible yet while its request is still being delivered. */
-    notFoundGraceMs?: number;
-    now?: () => number;
-    sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
-}
-/**
- * The provider runs on the server under a durable `image-generation:<requestId>`
- * operation; this client only waits for its result, retains it, and adds it as
- * the current version. Repeating a call with the same requestId collects the
- * same image and never starts a second generation.
- */
-export declare function createArtifactImageClient(endpoint: Endpoint, artifacts?: ArtifactClient, options?: ArtifactImageClientOptions): ArtifactImageClient;

package/dist/internal/endpoint/artifact-reducer.d.ts

@@ -1,35 +0,0 @@
-import { type ArtifactCommandRecord, type ArtifactFormValue, type ArtifactReadResult, type ArtifactSnapshot } from '../backend-contracts/index.js';
-/**
- * Integrity failures halt replay: a sequence gap, a changed artifact identity,
- * an unsupported codec, or an envelope written by a newer Canon. Nothing else does.
- */
-export declare class ArtifactReplayError extends Error {
-    readonly code: 'UNSUPPORTED_VERSION' | 'ARTIFACT_LOG_INVALID';
-    constructor(code: 'UNSUPPORTED_VERSION' | 'ARTIFACT_LOG_INVALID', message: string);
-}
-/** FEN without the half-move and full-move clocks. */
-export declare const chessPositionKey: (fen: string) => string;
-/** A form value that changed since the author looked. */
-export interface ArtifactConflict {
-    path: string[];
-    label: string;
-    expected: ArtifactFormValue;
-    current: ArtifactFormValue;
-    currentBy?: string;
-}
-/** Structured conflicts of a form command (form.set or form.fields) against the snapshot it was judged on. */
-export declare function artifactCommandConflicts(snapshot: ArtifactSnapshot, command: unknown): ArtifactConflict[];
-/** Structured conflicts of form.set changes against the snapshot they were judged on. */
-export declare function artifactFormConflicts(snapshot: ArtifactSnapshot, changes: unknown): ArtifactConflict[];
-/** Pure reduction of one relay record. Throws only for integrity halts. */
-export declare function reduceArtifactRecord(previous: ArtifactReadResult, record: ArtifactCommandRecord, conversationId: string): ArtifactReadResult;
-export interface ArtifactReplayPage {
-    previous: ArtifactReadResult;
-    commands: ArtifactCommandRecord[];
-    conversationId: string;
-    artifactId: string;
-    /** Stop once this revision is reached (historical read). */
-    revisionId?: string;
-}
-/** In-process replay of one log page. Built-in rules only: bounded and synchronous. */
-export declare function replayArtifactPage(page: ArtifactReplayPage): ArtifactReadResult;

package/dist/internal/endpoint/artifact-views.d.ts

@@ -1,113 +0,0 @@
-import { type ArtifactChessState, type ArtifactFormColumn, type ArtifactFormFieldType, type ArtifactFormRow, type ArtifactFormValue, type ArtifactKind, type ArtifactSnapshot } from '../backend-contracts/index.js';
-/** Readable projections of shared work for agents, prompts and compact UI. */
-export interface ArtifactPrincipalView {
-    id: string;
-    name?: string;
-    isYou?: boolean;
-}
-export interface ArtifactViewOptions {
-    /** The principal reading the view (marks `isYou`, seats and turn). */
-    viewerId?: string;
-    names?: Record<string, string>;
-    /** The snapshot this viewer saw last; adds `changesSinceLastView`. */
-    previous?: ArtifactSnapshot;
-}
-export interface ArtifactViewBase {
-    artifactId: string;
-    kind: ArtifactKind;
-    title: string;
-    revisionId: string;
-    archived: boolean;
-    createdBy: ArtifactPrincipalView;
-    updatedBy: ArtifactPrincipalView;
-    updatedAt: string;
-}
-export interface ArtifactChessMoveView {
-    ply: number;
-    notation: string;
-    san: string;
-    by: ArtifactPrincipalView;
-}
-export interface ArtifactChessView extends ArtifactViewBase {
-    kind: 'chess';
-    fen: string;
-    /** ASCII, rank 8 first, uppercase White, with file and rank labels. */
-    board: string;
-    turn: 'white' | 'black';
-    /** Full-move number. */
-    moveNumber: number;
-    /** e.g. "1. e4 e5 2. Nf3". */
-    moveList: string;
-    lastMove?: ArtifactChessMoveView;
-    players: {
-        white?: ArtifactPrincipalView;
-        black?: ArtifactPrincipalView;
-    };
-    yourColor?: 'white' | 'black';
-    yourTurn: boolean;
-    status: ArtifactChessState['status'];
-    result?: ArtifactChessState['result'];
-    resignedBy?: ArtifactPrincipalView;
-    check: boolean;
-    /** SAN, while the game is active. */
-    legalMoves?: string[];
-    /** Moves since the previous view. */
-    changesSinceLastView?: ArtifactChessMoveView[];
-}
-export interface ArtifactFormFieldView {
-    id: string;
-    label: string;
-    type: ArtifactFormFieldType;
-    value: ArtifactFormValue;
-    required?: boolean;
-    options?: string[];
-    placeholder?: string;
-    help?: string;
-    decimals?: number;
-}
-export interface ArtifactFormChangeView {
-    label: string;
-    path: string[];
-    before: ArtifactFormValue | Record<string, ArtifactFormValue>;
-    after: ArtifactFormValue | Record<string, ArtifactFormValue>;
-}
-export interface ArtifactFormView extends ArtifactViewBase {
-    kind: 'form';
-    fields: ArtifactFormFieldView[];
-    /** Labels of required fields that are empty. */
-    missingRequired: string[];
-    /**
-     * `sums` holds each summed column's total, rounded to the column's decimals.
-     * Form numbers are bounded, so a total is always finite; a total that is not
-     * (state written outside the shared rules) reads as null instead of failing.
-     */
-    table?: {
-        label?: string;
-        columns: ArtifactFormColumn[];
-        rows: ArtifactFormRow[];
-        sums: Record<string, number | null>;
-    };
-    changesSinceLastView?: ArtifactFormChangeView[];
-}
-export interface ArtifactImageVariantView {
-    id: string;
-    label: string;
-    prompt?: string;
-    by: ArtifactPrincipalView;
-    at: string;
-    sourceVariantId?: string;
-    assetId: string;
-    current: boolean;
-}
-export interface ArtifactImageView extends ArtifactViewBase {
-    kind: 'image';
-    variants: ArtifactImageVariantView[];
-    currentVariantId?: string;
-    /** Versions added since the previous view. */
-    changesSinceLastView?: ArtifactImageVariantView[];
-}
-export type ArtifactView = ArtifactChessView | ArtifactFormView | ArtifactImageView;
-export declare function chessBoardAscii(fen: string): string;
-export declare function describeArtifact(snapshot: ArtifactSnapshot, options?: ArtifactViewOptions): ArtifactView;
-/** One line, viewer-relative: "Chess “Game”: move 12, Black to move (you play Black). Your move. Last: 11...Nf6 by Alice." */
-export declare function summarizeArtifact(snapshot: ArtifactSnapshot, options?: Omit<ArtifactViewOptions, 'previous'>): string;

package/dist/internal/endpoint/artifacts.d.ts

@@ -1,75 +0,0 @@
-import { type ArtifactAsset, type ArtifactCommand, type ArtifactCommandBody, type ArtifactDefinition, type ArtifactDomainOutcome, type ArtifactOutcomeCode, type ArtifactReadResult, type ArtifactSnapshot } from '../backend-contracts/index.js';
-import type { Endpoint } from './engine.js';
-import { type ArtifactConflict } from './artifact-reducer.js';
-/** The command was rejected by the shared rules; nothing new was accepted. */
-export declare class ArtifactRejectedError extends Error {
-    readonly code: ArtifactOutcomeCode | 'UNSUPPORTED_VERSION';
-    readonly outcome?: ArtifactDomainOutcome;
-    readonly conflicts?: ArtifactConflict[];
-    /** The projection the command was evaluated against: the author's fresh state. */
-    readonly current?: ArtifactReadResult;
-    constructor(message: string, options: {
-        code: ArtifactOutcomeCode | 'UNSUPPORTED_VERSION';
-        outcome?: ArtifactDomainOutcome;
-        conflicts?: ArtifactConflict[];
-        current?: ArtifactReadResult;
-    });
-}
-/**
- * `accepted`: the relay stored the command and the shared rules accepted it.
- * `queued`: the durable outbox keeps retrying delivery; snapshot and outcome
- * are a local prediction. Callers must not resend.
- */
-export interface ArtifactWriteResult extends ArtifactReadResult {
-    outcome: ArtifactDomainOutcome;
-    status: 'accepted' | 'queued';
-}
-/** `unavailable` codes include NO_DEFINITION and ARTIFACT_LOADING (a long log still replaying; a later listing has it). */
-export interface ArtifactLibrary {
-    artifacts: ArtifactSnapshot[];
-    unavailable: Array<{
-        artifactId: string;
-        code: string;
-        message: string;
-    }>;
-}
-/** The client stamps the schema; a caller-supplied schema must match it. */
-export type ArtifactCommandInput = ArtifactCommandBody | ArtifactCommand;
-export interface ArtifactWriteOptions {
-    commandId?: string;
-    waitMs?: number;
-}
-export interface ArtifactCreateOptions {
-    artifactId?: string;
-    commandId?: string;
-    waitMs?: number;
-}
-export interface ArtifactClientOptions {
-    encoding?: 'json' | 'mls';
-    /** How long a listing waits for one work before reporting it as still loading (default 4 s). */
-    listItemWaitMs?: number;
-}
-export interface ArtifactClient {
-    list(conversationId: string): Promise<ArtifactLibrary>;
-    read(conversationId: string, artifactId: string, options?: {
-        revisionId?: string;
-    }): Promise<ArtifactReadResult>;
-    create(conversationId: string, definition: ArtifactDefinition, options?: ArtifactCreateOptions): Promise<ArtifactWriteResult>;
-    apply(conversationId: string, artifactId: string, command: ArtifactCommandInput, options?: ArtifactWriteOptions): Promise<ArtifactWriteResult>;
-    retainAsset(conversationId: string, artifactId: string, assetId: string): Promise<ArtifactAsset>;
-    getAsset(conversationId: string, artifactId: string, assetId: string): Promise<ArtifactAsset>;
-    /** Polls the log head only; reads (and replays) when it moves. */
-    observe(conversationId: string, artifactId: string, listener: (value: ArtifactReadResult) => void, onError?: (error: unknown) => void): () => void;
-    observeList(conversationId: string, listener: (value: ArtifactLibrary) => void, onError?: (error: unknown) => void): () => void;
-    /**
-     * An opaque command ID for one deliberate request: `cmd-` and 40 hex
-     * characters of an HMAC-SHA256 over the canonical JSON of `material`, keyed
-     * by this installation's secret. Stable for retries on this installation,
-     * unrelated elsewhere, and never a server-testable hash of its content.
-     * Throws PREPARATION_INSTALLATION_FENCED on an endpoint another logout fenced.
-     */
-    deriveCommandId(material: unknown[]): Promise<string>;
-    /** The same derivation (separate domain) as an RFC 4122-shaped UUID, for image request IDs. */
-    deriveRequestId(material: unknown[]): Promise<string>;
-}
-export declare function createArtifactClient(endpoint: Endpoint, options?: ArtifactClientOptions): ArtifactClient;