@canonmsg/agent-sdk 13.2.0 → 13.2.1

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;