totemlayer 0.1.25 → 0.1.30

package/bin/sdk/errors.js

@@ -1,67 +1 @@
-export class TotemError extends Error {
-    code;
-    status;
-    requestId;
-    retryAfterSeconds;
-    constructor(message, options) {
-        super(message, { cause: options.cause });
-        this.name = new.target.name;
-        this.code = options.code;
-        this.status = options.status;
-        this.requestId = options.requestId;
-        this.retryAfterSeconds = options.retryAfterSeconds;
-    }
-}
-export class TotemAuthenticationError extends TotemError {
-}
-export class TotemPermissionError extends TotemError {
-}
-export class TotemNotFoundError extends TotemError {
-}
-export class TotemConflictError extends TotemError {
-}
-export class TotemRateLimitError extends TotemError {
-}
-export class TotemTimeoutError extends TotemError {
-}
-export class TotemNetworkError extends TotemError {
-}
-export class TotemCanceledError extends TotemError {
-}
-export function apiError(status, body, requestId) {
-    const error = body &&
-        typeof body === "object" &&
-        "error" in body &&
-        body.error &&
-        typeof body.error === "object"
-        ? body.error
-        : {};
-    const message = "message" in error && typeof error.message === "string"
-        ? error.message
-        : `Totem request failed (${status}).`;
-    const code = "code" in error && typeof error.code === "string" ? error.code : "HTTP_ERROR";
-    const id = "requestId" in error && typeof error.requestId === "string" ? error.requestId : requestId;
-    const Constructor = status === 401
-        ? TotemAuthenticationError
-        : status === 403
-            ? TotemPermissionError
-            : status === 404
-                ? TotemNotFoundError
-                : status === 409
-                    ? TotemConflictError
-                    : status === 429
-                        ? TotemRateLimitError
-                        : TotemError;
-    const details = "details" in error ? error.details : undefined;
-    const retryAfter = details && typeof details === "object" && "retryAfterSeconds" in details
-        ? details.retryAfterSeconds
-        : undefined;
-    const retryAfterSeconds = status === 429 &&
-        typeof retryAfter === "number" &&
-        Number.isSafeInteger(retryAfter) &&
-        retryAfter > 0 &&
-        retryAfter <= 86400
-        ? retryAfter
-        : undefined;
-    return new Constructor(message, { code, status, requestId: id, retryAfterSeconds });
-}
+class TotemError extends Error{code;status;requestId;retryAfterSeconds;constructor(message,options){super(message,{cause:options.cause});this.name=new.target.name;this.code=options.code;this.status=options.status;this.requestId=options.requestId;this.retryAfterSeconds=options.retryAfterSeconds}}class TotemAuthenticationError extends TotemError{}class TotemPermissionError extends TotemError{}class TotemNotFoundError extends TotemError{}class TotemConflictError extends TotemError{}class TotemRateLimitError extends TotemError{}class TotemTimeoutError extends TotemError{}class TotemNetworkError extends TotemError{}class TotemCanceledError extends TotemError{}function apiError(status,body,requestId){const error=body&&typeof body==="object"&&"error"in body&&body.error&&typeof body.error==="object"?body.error:{};const message="message"in error&&typeof error.message==="string"?error.message:`Totem request failed (${status}).`;const code="code"in error&&typeof error.code==="string"?error.code:"HTTP_ERROR";const id="requestId"in error&&typeof error.requestId==="string"?error.requestId:requestId;const Constructor=status===401?TotemAuthenticationError:status===403?TotemPermissionError:status===404?TotemNotFoundError:status===409?TotemConflictError:status===429?TotemRateLimitError:TotemError;const details="details"in error?error.details:void 0;const retryAfter=details&&typeof details==="object"&&"retryAfterSeconds"in details?details.retryAfterSeconds:void 0;const retryAfterSeconds=status===429&&typeof retryAfter==="number"&&Number.isSafeInteger(retryAfter)&&retryAfter>0&&retryAfter<=86400?retryAfter:void 0;return new Constructor(message,{code,status,requestId:id,retryAfterSeconds})}export{TotemAuthenticationError,TotemCanceledError,TotemConflictError,TotemError,TotemNetworkError,TotemNotFoundError,TotemPermissionError,TotemRateLimitError,TotemTimeoutError,apiError};

package/bin/sdk/index.d.ts

@@ -1,6 +1,6 @@
 import { createLocalInspector, InspectionError } from "./inspector.js";
 import type { ActionProposal, AssistantActionCheck, AssistantActionCheckList, AssistantActionReceiptResult, AssistantCheckOptions } from "./action-types.js";
-import type { MissionCoordinationUpdate, MissionSessionReport, Agent, AssistantContext, AssistantMissionPermissions, Attachment, Chat, ChatCommand, ChatDetail, ChatEvent, ChatRun, RuntimeHeartbeat, Conversation, ListenOptions, ListMessages, ListMissions, ListTasks, Message, MessageContent, MessageHandler, Metadata, MissionArtifact, MissionDetail, MissionEvent, MissionEventInput, MissionSummary, MissionWorkItem, Page, Pagination, RequestOptions, RepoClaim, RepoClaimState, RepositoryCoordination, SearchAgents, SendMessage, Subscription, Task, TaskState, TotemOptions, WriteOptions } from "./types.js";
+import type { MissionCoordinationUpdate, MissionSessionReport, Agent, AssistantContext, AssistantMissionPermissions, Attachment, Chat, ChatCommand, ChatDetail, ChatEvent, ChatRun, RuntimeHeartbeat, Conversation, ListenOptions, ListMessages, ListMissions, ListTasks, Message, MessageContent, MessageHandler, Metadata, MissionArtifact, MissionDetail, MissionEvent, MissionEventInput, MissionSummary, MissionWorkItem, Page, Pagination, RequestOptions, RepoClaim, RepoClaimState, RepositoryCoordination, SearchAgents, SendMessage, Subscription, Task, TaskState, TotemOptions, WriteOptions, NetworkActivityPage, NetworkActionInput, NetworkActionRequest, NetworkProtectedAction } from "./types.js";
 export * from "./types.js";
 export * from "./errors.js";
 export * from "./actions.js";
@@ -11,6 +11,38 @@ export declare class Totem {
     static connect(options: TotemOptions): Promise<ConnectedAgent>;
     connect(): Promise<ConnectedAgent>;
     agent(options?: RequestOptions): Promise<Agent>;
+    activity: {
+        list: (query?: { cursor?: string; limit?: number }, options?: RequestOptions) => Promise<NetworkActivityPage>;
+    };
+    /** Native Network authorization. Human approval remains in the receiving owner's conversation. */
+    actions: {
+        list: (query?: {
+            state?: Exclude<NetworkActionRequest["state"], "expired">;
+            direction?: "inbound" | "outbound";
+            cursor?: string;
+            limit?: number;
+        }, options?: RequestOptions) => Promise<Page<NetworkActionRequest>>;
+        request: (input: NetworkActionInput, options?: WriteOptions) => Promise<NetworkActionRequest>;
+        get: (id: string, options?: RequestOptions) => Promise<NetworkActionRequest>;
+        dispatch: (id: string, input: {
+            digest: string;
+            action: NetworkProtectedAction;
+        }, options?: RequestOptions) => Promise<NetworkActionRequest>;
+        complete: (id: string, input: {
+            executionId: string;
+            outcome: "succeeded" | "failed" | "uncertain";
+            summary: string;
+        }, options?: RequestOptions) => Promise<NetworkActionRequest>;
+        cancel: (id: string, options?: RequestOptions) => Promise<NetworkActionRequest>;
+        /** Execute one registered local operation after the exact receiver approval is consumed. */
+        run: <T>(id: string, action: NetworkProtectedAction, execute: (approved: NetworkProtectedAction, executionId: string) => Promise<{
+            value: T;
+            summary: string;
+        }>, options?: RequestOptions) => Promise<{
+            value: T;
+            receipt: NetworkActionRequest;
+        }>;
+    };
     assistant: {
         context: (options?: RequestOptions) => Promise<AssistantContext>;
         checks: {
@@ -235,6 +267,7 @@ export declare class Totem {
         postUpdate: (id: string, text: string, options?: WriteOptions) => Promise<Message>;
         update: (id: string, input: {
             state: Exclude<TaskState, "submitted" | "canceled">;
+            statusMessage?: NonNullable<Task["statusMessage"]>;
             artifacts?: Task["artifacts"];
             expectedVersion?: number;
         }, options?: RequestOptions) => Promise<Task>;

package/bin/sdk/index.js

@@ -1,433 +1 @@
-import { TotemError } from "./errors.js";
-import { createLocalInspector, InspectionError } from "./inspector.js";
-import { idempotencyKey, sleep, Transport } from "./transport.js";
-import { assertInputFields, assistantCheckOptions, signalOnlyOptions } from "./request-options.js";
-export * from "./types.js";
-export * from "./errors.js";
-export * from "./actions.js";
-export { idempotencyKey } from "./transport.js";
-function content(input) {
-    // Runtime callers (including JavaScript) cannot accidentally provide a sender.
-    if ("from" in input)
-        throw new TotemError("Sender identity comes from the API key.", { code: "INVALID_MESSAGE" });
-    return input.content ?? { type: "text", text: input.text ?? input.message };
-}
-async function* paginate(fetchPage, cursor) {
-    const seen = new Set();
-    if (cursor)
-        seen.add(cursor);
-    do {
-        const page = await fetchPage(cursor);
-        for (const item of page.data)
-            yield item;
-        cursor = page.nextCursor ?? undefined;
-        if (cursor && seen.has(cursor))
-            throw new TotemError("Totem returned a repeated pagination cursor.", {
-                code: "INVALID_RESPONSE",
-            });
-        if (cursor)
-            seen.add(cursor);
-    } while (cursor);
-}
-export class Totem {
-    #transport;
-    #address;
-    constructor(options) {
-        this.#transport = new Transport(options);
-        this.#address = options.address?.trim().toLowerCase();
-    }
-    static async connect(options) {
-        return new Totem(options).connect();
-    }
-    async connect() {
-        const identity = await this.agent();
-        if (this.#address && this.#address !== identity.address.toLowerCase()) {
-            throw new TotemError("The configured address does not match the authenticated agent.", {
-                code: "IDENTITY_MISMATCH",
-            });
-        }
-        return new ConnectedAgent(this, identity);
-    }
-    async agent(options) {
-        return (await this.#transport.request("GET", "/agents/me", options)).data;
-    }
-    assistant = {
-        context: async (options) => (await this.#transport.request("GET", "/assistant/context", signalOnlyOptions(options))).data,
-        checks: {
-            create: async (missionId, input, options) => {
-                assertInputFields(input, ["workItemId", "leaseToken", "action"]);
-                return (await this.#transport.request("POST", `/assistant/missions/${encodeURIComponent(missionId)}/action-checks`, { ...assistantCheckOptions(options), body: input })).data;
-            },
-            list: async (missionId, workItemId, options) => (await this.#transport.request("GET", `/assistant/missions/${encodeURIComponent(missionId)}/action-checks`, { ...signalOnlyOptions(options), query: { workItemId } })).data,
-            recordReceipt: async (missionId, suiteId, input, options) => {
-                assertInputFields(input, ["workItemId"]);
-                return (await this.#transport.request("POST", `/assistant/missions/${encodeURIComponent(missionId)}/action-checks/${encodeURIComponent(suiteId)}/receipt`, { ...signalOnlyOptions(options), body: input })).data;
-            },
-        },
-        permissions: async (missionId, options) => (await this.#transport.request("GET", `/assistant/missions/${encodeURIComponent(missionId)}/permissions`, signalOnlyOptions(options))).data,
-    };
-    async resolve(address, options) {
-        return (await this.#transport.request("GET", `/resolve/${encodeURIComponent(address)}`, options)).data;
-    }
-    agents = {
-        search: (query = {}, options) => this.#transport.request("GET", "/agents/search", { ...options, query }),
-        iterate: (query = {}, options) => paginate((cursor) => this.agents.search({ ...query, cursor }, options), query.cursor),
-    };
-    attachments = {
-        upload: async (name, mediaType, bytes, options = {}) => {
-            if (!bytes.byteLength || bytes.byteLength > 2 * 1024 * 1024)
-                throw new TotemError("Attachments must be nonempty and no larger than 2 MiB.", {
-                    code: "ATTACHMENT_SIZE_INVALID",
-                });
-            return (await this.#transport.request("POST", "/attachments", {
-                ...options,
-                binaryBody: bytes,
-                headers: { "Content-Type": mediaType, "X-Totem-File-Name": encodeURIComponent(name) },
-            })).data;
-        },
-        download: (id, options) => this.#transport.download(`/attachments/${encodeURIComponent(id)}`, options),
-    };
-    messages = {
-        send: async (input, options = {}) => {
-            const body = { ...input, content: content(input) };
-            delete body.text;
-            delete body.message;
-            return (await this.#transport.request("POST", "/messages", {
-                ...options,
-                body,
-                idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-            })).data;
-        },
-        list: (query = {}, options) => this.#transport.request("GET", "/messages", { ...options, query }),
-        iterate: (query = {}, options) => paginate((cursor) => this.messages.list({ ...query, cursor }, options), query.cursor),
-        get: async (id, options) => (await this.#transport.request("GET", `/messages/${encodeURIComponent(id)}`, options)).data,
-        reply: async (id, text, options = {}) => (await this.#transport.request("POST", `/messages/${encodeURIComponent(id)}/reply`, {
-            ...options,
-            body: {
-                content: {
-                    type: "text",
-                    text,
-                    ...(options.attachments ? { attachments: options.attachments } : {}),
-                },
-                ...(options.metadata ? { metadata: options.metadata } : {}),
-            },
-            idempotencyKey: options.idempotencyKey ?? `sdk:reply:${id}`,
-        })).data,
-        replyContent: async (id, content, options = {}) => (await this.#transport.request("POST", `/messages/${encodeURIComponent(id)}/reply`, {
-            ...options,
-            body: { content },
-            idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-        })).data,
-        ack: async (id, options) => (await this.#transport.request("POST", `/messages/${encodeURIComponent(id)}/ack`, {
-            ...options,
-            body: {},
-            retrySafe: true,
-        })).data,
-    };
-    send(input, textOrOptions, options) {
-        if (typeof input === "string")
-            return this.messages.send({ to: input, text: textOrOptions }, options);
-        return this.messages.send(input, textOrOptions);
-    }
-    conversations = {
-        create: async (input, options) => {
-            // Creation has no automatic retry until the server supports an idempotent contract.
-            const result = await this.#transport.request("POST", "/conversations", { ...options, body: input });
-            return new ConversationHandle(this, result.data, input.with);
-        },
-        list: (query = {}, options) => this.#transport.request("GET", "/conversations", { ...options, query }),
-        get: async (id, options) => (await this.#transport.request("GET", `/conversations/${encodeURIComponent(id)}`, options)).data,
-        messages: (id, query = {}, options) => this.#transport.request("GET", `/conversations/${encodeURIComponent(id)}/messages`, {
-            ...options,
-            query,
-        }),
-    };
-    startConversation(input, options) {
-        return this.conversations.create(input, options);
-    }
-    missions = {
-        list: async (options) => (await this.#transport.request("GET", "/missions", options)).data.missions,
-        listPage: async (query = {}, options) => {
-            const page = await this.#transport.request("GET", "/missions", { ...options, query });
-            return { data: page.data.missions, nextCursor: page.nextCursor ?? null };
-        },
-        iterate: (query = {}, options) => paginate((cursor) => this.missions.listPage({ ...query, cursor }, options), query.cursor),
-        get: async (id, options) => {
-            const result = await this.#transport.request("GET", `/missions/${encodeURIComponent(id)}`, options);
-            return {
-                ...result.data.mission,
-                members: result.data.members,
-                workItems: result.data.workItems,
-                artifacts: result.data.artifacts,
-                events: result.data.events,
-                budget: result.data.budget,
-                coordination: result.data.coordination,
-            };
-        },
-        coordination: async (id, version, options) => (await this.#transport.request("GET", `/missions/${encodeURIComponent(id)}/coordination`, {
-            ...options,
-            query: { version },
-        })).data,
-        sessions: {
-            report: async (id, input, options) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/sessions`, {
-                ...options,
-                body: input,
-                retrySafe: true,
-            })).data,
-        },
-        workItems: async (id, options) => (await this.#transport.request("GET", `/missions/${encodeURIComponent(id)}/work-items`, options)).data.workItems,
-        /** Empty data can still have a nextCursor: readiness is checked after scanning candidates. */
-        workItemsPage: async (id, query = {}, options) => {
-            const page = await this.#transport.request("GET", `/missions/${encodeURIComponent(id)}/work-items`, { ...options, query });
-            return { data: page.data.workItems, nextCursor: page.nextCursor ?? null };
-        },
-        iterateWorkItems: (id, query = {}, options) => paginate((cursor) => this.missions.workItemsPage(id, { ...query, cursor }, options), query.cursor),
-        assign: async (id, input, options = {}) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/work-items`, {
-            ...options,
-            body: input,
-            idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-        })).data,
-        claim: async (id, workItemId, options) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/work-items/${encodeURIComponent(workItemId)}/claim`, { ...options, body: {} })).data,
-        renew: async (id, workItemId, leaseToken, options) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/work-items/${encodeURIComponent(workItemId)}/renew`, { ...options, body: { leaseToken }, retrySafe: true })).data,
-        complete: async (id, workItemId, input, options = {}) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/work-items/${encodeURIComponent(workItemId)}/complete`, { ...options, body: input, idempotencyKey: options.idempotencyKey ?? idempotencyKey() })).data,
-        reserveEffect: async (id, input, options = {}) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/effects`, {
-            ...options,
-            body: input,
-            idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-        })).data,
-        listEffects: async (id, workItemId, options) => (await this.#transport.request("GET", `/missions/${encodeURIComponent(id)}/effects`, {
-            ...options,
-            query: { workItemId },
-        })).data.effects,
-        dispatchEffect: async (id, effectId, leaseToken, options) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/effects/${encodeURIComponent(effectId)}/dispatch`, {
-            ...options,
-            body: { leaseToken },
-        })).data,
-        settleEffect: async (id, effectId, input, options) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/effects/${encodeURIComponent(effectId)}/settle`, { ...options, body: input, retrySafe: true })).data,
-        events: {
-            list: (id, query = {}, options) => this.#transport.request("GET", `/missions/${encodeURIComponent(id)}/events`, {
-                ...options,
-                query,
-            }),
-            iterate: (id, query = {}, options) => paginate((cursor) => this.missions.events.list(id, { ...query, cursor }, options), query.cursor),
-            post: async (id, input, options = {}) => {
-                if ("from" in input || "sender" in input || "actor" in input)
-                    throw new TotemError("Mission event actors come from the agent credential.", {
-                        code: "INVALID_EVENT",
-                    });
-                return (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/events`, { ...options, body: input, idempotencyKey: options.idempotencyKey ?? idempotencyKey() })).data;
-            },
-            ack: async (id, eventId, options) => (await this.#transport.request("POST", `/missions/${encodeURIComponent(id)}/events/${encodeURIComponent(eventId)}/ack`, { ...options, body: {}, retrySafe: true })).data,
-        },
-    };
-    chats = {
-        list: (query = {}, options) => this.#transport.request("GET", "/chats", { ...options, query }),
-        get: async (id, options = {}) => (await this.#transport.request("GET", `/chats/${encodeURIComponent(id)}`, {
-            signal: options.signal,
-            query: { cursor: options.cursor, before: options.before, limit: options.limit },
-        })).data,
-        /** Publish as the authenticated agent; this never creates a human command. */
-        updates: async (id, text, options = {}) => (await this.#transport.request("POST", `/chats/${encodeURIComponent(id)}/updates`, {
-            ...options,
-            body: { text },
-            idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-        })).data,
-    };
-    chatCommands = {
-        list: (query = {}, options) => this.#transport.request("GET", "/chat-commands", { ...options, query }),
-        claim: async (id, options) => (await this.#transport.request("POST", `/chat-commands/${encodeURIComponent(id)}/claim`, { ...options, body: {} })).data,
-        renew: async (id, leaseToken, options) => (await this.#transport.request("POST", `/chat-commands/${encodeURIComponent(id)}/renew`, { ...options, body: { leaseToken }, retrySafe: true })).data,
-        complete: async (id, input, options = {}) => (await this.#transport.request("POST", `/chat-commands/${encodeURIComponent(id)}/complete`, { ...options, body: input, idempotencyKey: options.idempotencyKey ?? idempotencyKey() })).data,
-        fail: async (id, input, options) => (await this.#transport.request("POST", `/chat-commands/${encodeURIComponent(id)}/fail`, { ...options, body: input, retrySafe: true })).data,
-    };
-    runtime = {
-        activations: async (options) => (await this.#transport.request("GET", "/runtime/activations", options)).data,
-        reportActivation: async (input, options) => (await this.#transport.request("POST", "/runtime/activations", { ...options, body: input, retrySafe: true })).data,
-        start: async (input, options) => (await this.#transport.request("POST", "/runtime/start", { ...options, body: input, retrySafe: true })).data,
-        probe: async (runId, options) => (await this.#transport.request("GET", "/runtime/probe", { ...options, query: { runId } })).data,
-        replyProbe: async (input, options) => (await this.#transport.request("POST", "/runtime/probe", { ...options, body: input, retrySafe: true })).data,
-        heartbeat: async (input = {}, options) => (await this.#transport.request("POST", "/runtime/heartbeat", {
-            ...options,
-            body: input,
-            retrySafe: true,
-        })).data,
-    };
-    tasks = {
-        create: async (input, options = {}) => (await this.#transport.request("POST", "/tasks", {
-            ...options,
-            body: {
-                to: input.to,
-                content: content(input),
-                conversationId: input.conversationId,
-                metadata: input.metadata,
-                ttlSeconds: input.ttlSeconds,
-                authorization: input.authorization,
-            },
-            idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-        })).data,
-        get: async (id, options) => (await this.#transport.request("GET", `/tasks/${encodeURIComponent(id)}`, options)).data,
-        list: (query = {}, options) => this.#transport.request("GET", "/tasks", { ...options, query }),
-        iterate: (query = {}, options) => paginate((cursor) => this.tasks.list({ ...query, cursor }, options), query.cursor),
-        postUpdate: async (id, text, options = {}) => (await this.#transport.request("POST", `/tasks/${encodeURIComponent(id)}/messages`, {
-            ...options,
-            body: { content: { type: "text", text } },
-            idempotencyKey: options.idempotencyKey ?? idempotencyKey(),
-        })).data,
-        update: async (id, input, options) => (await this.#transport.request("PATCH", `/tasks/${encodeURIComponent(id)}`, {
-            ...options,
-            body: input,
-        })).data,
-        cancel: async (id, options) => (await this.#transport.request("POST", `/tasks/${encodeURIComponent(id)}/cancel`, { ...options, body: {} })).data,
-    };
-    repositories = {
-        getTask: async (taskId, options) => (await this.#transport.request("GET", `/tasks/${encodeURIComponent(taskId)}/repository`, options)).data,
-        claim: async (taskId, input, options) => (await this.#transport.request("POST", `/tasks/${encodeURIComponent(taskId)}/repository`, { ...options, body: input })).data,
-        update: async (taskId, input, options) => (await this.#transport.request("PATCH", `/tasks/${encodeURIComponent(taskId)}/repository`, { ...options, body: input })).data,
-    };
-    github = {
-        repositories: async (options) => (await this.#transport.request("GET", "/github/repositories", options)).data,
-        openPullRequest: async (taskId, input, options) => (await this.#transport.request("POST", `/github/pull-requests?taskId=${encodeURIComponent(taskId)}`, { ...options, body: input })).data,
-    };
-}
-export class ConversationHandle {
-    id;
-    conversation;
-    #totem;
-    #recipient;
-    constructor(totem, conversation, recipient) {
-        this.#totem = totem;
-        this.conversation = conversation;
-        this.id = conversation.id;
-        this.#recipient = recipient;
-    }
-    send(text, options) {
-        return this.#totem.messages.send({ to: this.#recipient, text, conversationId: this.id }, options);
-    }
-    messages(query = {}, options) {
-        return this.#totem.conversations.messages(this.id, query, options);
-    }
-}
-export class ConnectedAgent {
-    identity;
-    address;
-    client;
-    #subscription;
-    #lastError;
-    constructor(client, identity) {
-        this.client = client;
-        this.identity = identity;
-        this.address = identity.address;
-    }
-    get lastError() {
-        return this.#lastError;
-    }
-    send(input, textOrOptions, options) {
-        return typeof input === "string"
-            ? this.client.send(input, textOrOptions, options)
-            : this.client.send(input, textOrOptions);
-    }
-    startConversation(input) {
-        return this.client.startConversation(input);
-    }
-    on(event, handler, options = {}) {
-        if (event !== "message")
-            throw new TotemError("Only message subscriptions are supported.", { code: "INVALID_EVENT" });
-        if (this.#subscription)
-            throw new TotemError("This agent already has a message listener.", {
-                code: "ALREADY_LISTENING",
-            });
-        const interval = options.pollIntervalMs ?? 1000;
-        if (!Number.isFinite(interval) || interval < 10)
-            throw new TotemError("pollIntervalMs must be at least 10.", { code: "INVALID_CONFIG" });
-        const controller = new AbortController();
-        const inspector = options.inspector ?? createLocalInspector();
-        const blocked = new Set();
-        const report = (cause) => {
-            this.#lastError = cause instanceof Error ? cause : new Error(String(cause));
-            try {
-                options.onError?.(this.#lastError);
-            }
-            catch {
-                /* Error reporting cannot acknowledge an unprocessed message. */
-            }
-        };
-        const done = (async () => {
-            while (!controller.signal.aborted) {
-                try {
-                    for await (const message of this.client.messages.iterate({ direction: "inbound", unread: true, limit: 100 }, { signal: controller.signal })) {
-                        if (controller.signal.aborted)
-                            break;
-                        if (blocked.has(message.id))
-                            continue;
-                        try {
-                            if (message.content.type === "encrypted")
-                                throw new TotemError("Use E2eeTotem and pinned endpoint keys to process encrypted messages.", { code: "E2EE_CLIENT_REQUIRED" });
-                            await inspector.assertAllowed("input", { content: message.content, metadata: message.metadata ?? {} }, { signal: controller.signal });
-                            const files = message.attachments ?? [];
-                            const ids = new Set(files.map((file) => file.id));
-                            if (message.content.type === "text" &&
-                                message.content.attachments?.some((id) => !ids.has(id)))
-                                throw new InspectionError("INSPECTION_UNSUPPORTED_FILE");
-                            for (const file of files) {
-                                const downloaded = await this.client.attachments.download(file.id, {
-                                    signal: controller.signal,
-                                });
-                                await inspector.inspectFile(file.name, file.mediaType, downloaded.bytes, {
-                                    signal: controller.signal,
-                                });
-                            }
-                            const incoming = {
-                                ...message,
-                                text: message.content.type === "text"
-                                    ? message.content.text
-                                    : JSON.stringify(message.content.data),
-                                reply: (text, writeOptions = {}) => inspector.runAction({ id: message.id, text }, (input) => this.client.messages.reply(input.id, input.text, {
-                                    ...writeOptions,
-                                    idempotencyKey: writeOptions.idempotencyKey ?? `reply:${message.id}:0`,
-                                }), { signal: controller.signal }),
-                                ack: () => this.client.messages.ack(message.id),
-                            };
-                            await handler(incoming);
-                            await incoming.ack();
-                        }
-                        catch (error) {
-                            if (error instanceof InspectionError && error.code !== "INSPECTION_UNAVAILABLE")
-                                blocked.add(message.id);
-                            report(error);
-                        }
-                    }
-                }
-                catch (error) {
-                    if (!controller.signal.aborted)
-                        report(error);
-                }
-                if (!controller.signal.aborted) {
-                    try {
-                        await sleep(interval, controller.signal);
-                    }
-                    catch {
-                        /* stop wakes the poller. */
-                    }
-                }
-            }
-        })();
-        const subscription = {
-            done,
-            stop: async () => {
-                controller.abort();
-                await done;
-                if (this.#subscription === subscription)
-                    this.#subscription = undefined;
-            },
-        };
-        this.#subscription = subscription;
-        return subscription;
-    }
-    async stop() {
-        await this.#subscription?.stop();
-    }
-}
-/** Compatibility name for callers who prefer `new TotemAgent({ address, apiKey })`. */
-export class TotemAgent extends Totem {
-}
-export { createLocalInspector, InspectionError };
+import{TotemError}from"./errors.js";import{createLocalInspector,InspectionError}from"./inspector.js";import{idempotencyKey,sleep,Transport}from"./transport.js";import{assertInputFields,assistantCheckOptions,signalOnlyOptions}from"./request-options.js";export*from"./types.js";export*from"./errors.js";export*from"./actions.js";import{idempotencyKey as idempotencyKey2}from"./transport.js";function content(input){if("from"in input)throw new TotemError("Sender identity comes from the API key.",{code:"INVALID_MESSAGE"});return input.content??{type:"text",text:input.text??input.message}}async function*paginate(fetchPage,cursor){const seen=new Set;if(cursor)seen.add(cursor);do{const page=await fetchPage(cursor);for(const item of page.data)yield item;cursor=page.nextCursor??void 0;if(cursor&&seen.has(cursor))throw new TotemError("Totem returned a repeated pagination cursor.",{code:"INVALID_RESPONSE"});if(cursor)seen.add(cursor)}while(cursor)}class Totem{#transport;#address;constructor(options){this.#transport=new Transport(options);this.#address=options.address?.trim().toLowerCase()}static async connect(options){return new Totem(options).connect()}async connect(){const identity=await this.agent();if(this.#address&&this.#address!==identity.address.toLowerCase()){throw new TotemError("The configured address does not match the authenticated agent.",{code:"IDENTITY_MISMATCH"})}return new ConnectedAgent(this,identity)}async agent(options){return(await this.#transport.request("GET","/agents/me",options)).data}activity={list:(query={},options)=>this.#transport.request("GET","/activity",{...signalOnlyOptions(options),query})};actions={list:(query={},options)=>this.#transport.request("GET","/actions",{...signalOnlyOptions(options),query}),request:async(input,options={})=>{assertInputFields(input,["to","action","description","conversationId","taskId","ttlSeconds"]);const{idempotencyKey:key,...requestOptions}=options;return(await this.#transport.request("POST","/actions",{...signalOnlyOptions(requestOptions),body:input,idempotencyKey:key??idempotencyKey()})).data},get:async(id,options)=>(await this.#transport.request("GET",`/actions/${encodeURIComponent(id)}`,signalOnlyOptions(options))).data,dispatch:async(id,input,options)=>{assertInputFields(input,["digest","action"]);return(await this.#transport.request("POST",`/actions/${encodeURIComponent(id)}/dispatch`,{...signalOnlyOptions(options),body:input})).data},complete:async(id,input,options)=>{assertInputFields(input,["executionId","outcome","summary"]);return(await this.#transport.request("POST",`/actions/${encodeURIComponent(id)}/complete`,{...signalOnlyOptions(options),body:input,retrySafe:true})).data},cancel:async(id,options)=>(await this.#transport.request("POST",`/actions/${encodeURIComponent(id)}/cancel`,{...signalOnlyOptions(options),retrySafe:true})).data,run:async(id,action,execute,options)=>{const requestOptions=signalOnlyOptions(options);const current=await this.actions.get(id,requestOptions);const dispatched=await this.actions.dispatch(id,{action,digest:current.digest},requestOptions);if(!dispatched.executionAuthorized||!dispatched.executionId)throw new TotemError("No execution permission was granted.",{code:"NETWORK_ACTION_DISPATCH_INVALID"});let result;try{result=await execute(structuredClone(dispatched.action),dispatched.executionId)}catch(cause){try{await this.actions.complete(id,{executionId:dispatched.executionId,outcome:"uncertain",summary:"The local executor stopped without a confirmed outcome. Inspect before repeating any effect."})}catch{}throw new TotemError("Action outcome uncertain. Inspect it; do not repeat.",{code:"NETWORK_ACTION_OUTCOME_UNCERTAIN",cause})}try{const receipt=await this.actions.complete(id,{executionId:dispatched.executionId,outcome:"succeeded",summary:result.summary},requestOptions);return{value:result.value,receipt}}catch(cause){throw new TotemError("Action finished; receipt pending. Reconcile it without reexecuting.",{code:"NETWORK_ACTION_RECEIPT_PENDING",cause})}}};assistant={context:async options=>(await this.#transport.request("GET","/assistant/context",signalOnlyOptions(options))).data,checks:{create:async(missionId,input,options)=>{assertInputFields(input,["workItemId","leaseToken","action"]);return(await this.#transport.request("POST",`/assistant/missions/${encodeURIComponent(missionId)}/action-checks`,{...assistantCheckOptions(options),body:input})).data},list:async(missionId,workItemId,options)=>(await this.#transport.request("GET",`/assistant/missions/${encodeURIComponent(missionId)}/action-checks`,{...signalOnlyOptions(options),query:{workItemId}})).data,recordReceipt:async(missionId,suiteId,input,options)=>{assertInputFields(input,["workItemId"]);return(await this.#transport.request("POST",`/assistant/missions/${encodeURIComponent(missionId)}/action-checks/${encodeURIComponent(suiteId)}/receipt`,{...signalOnlyOptions(options),body:input})).data}},permissions:async(missionId,options)=>(await this.#transport.request("GET",`/assistant/missions/${encodeURIComponent(missionId)}/permissions`,signalOnlyOptions(options))).data};async resolve(address,options){return(await this.#transport.request("GET",`/resolve/${encodeURIComponent(address)}`,options)).data}agents={search:(query={},options)=>this.#transport.request("GET","/agents/search",{...options,query}),iterate:(query={},options)=>paginate(cursor=>this.agents.search({...query,cursor},options),query.cursor)};attachments={upload:async(name,mediaType,bytes,options={})=>{if(!bytes.byteLength||bytes.byteLength>2*1024*1024)throw new TotemError("Attachments must be nonempty and no larger than 2 MiB.",{code:"ATTACHMENT_SIZE_INVALID"});return(await this.#transport.request("POST","/attachments",{...options,binaryBody:bytes,headers:{"Content-Type":mediaType,"X-Totem-File-Name":encodeURIComponent(name)}})).data},download:(id,options)=>this.#transport.download(`/attachments/${encodeURIComponent(id)}`,options)};messages={send:async(input,options={})=>{const body={...input,content:content(input)};delete body.text;delete body.message;return(await this.#transport.request("POST","/messages",{...options,body,idempotencyKey:options.idempotencyKey??idempotencyKey()})).data},list:(query={},options)=>this.#transport.request("GET","/messages",{...options,query}),iterate:(query={},options)=>paginate(cursor=>this.messages.list({...query,cursor},options),query.cursor),get:async(id,options)=>(await this.#transport.request("GET",`/messages/${encodeURIComponent(id)}`,options)).data,reply:async(id,text,options={})=>(await this.#transport.request("POST",`/messages/${encodeURIComponent(id)}/reply`,{...options,body:{content:{type:"text",text,...options.attachments?{attachments:options.attachments}:{}},...options.metadata?{metadata:options.metadata}:{}},idempotencyKey:options.idempotencyKey??`sdk:reply:${id}`})).data,replyContent:async(id,content2,options={})=>(await this.#transport.request("POST",`/messages/${encodeURIComponent(id)}/reply`,{...options,body:{content:content2},idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,ack:async(id,options)=>(await this.#transport.request("POST",`/messages/${encodeURIComponent(id)}/ack`,{...options,body:{},retrySafe:true})).data};send(input,textOrOptions,options){if(typeof input==="string")return this.messages.send({to:input,text:textOrOptions},options);return this.messages.send(input,textOrOptions)}conversations={create:async(input,options)=>{const result=await this.#transport.request("POST","/conversations",{...options,body:input});return new ConversationHandle(this,result.data,input.with)},list:(query={},options)=>this.#transport.request("GET","/conversations",{...options,query}),get:async(id,options)=>(await this.#transport.request("GET",`/conversations/${encodeURIComponent(id)}`,options)).data,messages:(id,query={},options)=>this.#transport.request("GET",`/conversations/${encodeURIComponent(id)}/messages`,{...options,query})};startConversation(input,options){return this.conversations.create(input,options)}missions={list:async options=>(await this.#transport.request("GET","/missions",options)).data.missions,listPage:async(query={},options)=>{const page=await this.#transport.request("GET","/missions",{...options,query});return{data:page.data.missions,nextCursor:page.nextCursor??null}},iterate:(query={},options)=>paginate(cursor=>this.missions.listPage({...query,cursor},options),query.cursor),get:async(id,options)=>{const result=await this.#transport.request("GET",`/missions/${encodeURIComponent(id)}`,options);return{...result.data.mission,members:result.data.members,workItems:result.data.workItems,artifacts:result.data.artifacts,events:result.data.events,budget:result.data.budget,coordination:result.data.coordination}},coordination:async(id,version,options)=>(await this.#transport.request("GET",`/missions/${encodeURIComponent(id)}/coordination`,{...options,query:{version}})).data,sessions:{report:async(id,input,options)=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/sessions`,{...options,body:input,retrySafe:true})).data},workItems:async(id,options)=>(await this.#transport.request("GET",`/missions/${encodeURIComponent(id)}/work-items`,options)).data.workItems,workItemsPage:async(id,query={},options)=>{const page=await this.#transport.request("GET",`/missions/${encodeURIComponent(id)}/work-items`,{...options,query});return{data:page.data.workItems,nextCursor:page.nextCursor??null}},iterateWorkItems:(id,query={},options)=>paginate(cursor=>this.missions.workItemsPage(id,{...query,cursor},options),query.cursor),assign:async(id,input,options={})=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/work-items`,{...options,body:input,idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,claim:async(id,workItemId,options)=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/work-items/${encodeURIComponent(workItemId)}/claim`,{...options,body:{}})).data,renew:async(id,workItemId,leaseToken,options)=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/work-items/${encodeURIComponent(workItemId)}/renew`,{...options,body:{leaseToken},retrySafe:true})).data,complete:async(id,workItemId,input,options={})=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/work-items/${encodeURIComponent(workItemId)}/complete`,{...options,body:input,idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,reserveEffect:async(id,input,options={})=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/effects`,{...options,body:input,idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,listEffects:async(id,workItemId,options)=>(await this.#transport.request("GET",`/missions/${encodeURIComponent(id)}/effects`,{...options,query:{workItemId}})).data.effects,dispatchEffect:async(id,effectId,leaseToken,options)=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/effects/${encodeURIComponent(effectId)}/dispatch`,{...options,body:{leaseToken}})).data,settleEffect:async(id,effectId,input,options)=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/effects/${encodeURIComponent(effectId)}/settle`,{...options,body:input,retrySafe:true})).data,events:{list:(id,query={},options)=>this.#transport.request("GET",`/missions/${encodeURIComponent(id)}/events`,{...options,query}),iterate:(id,query={},options)=>paginate(cursor=>this.missions.events.list(id,{...query,cursor},options),query.cursor),post:async(id,input,options={})=>{if("from"in input||"sender"in input||"actor"in input)throw new TotemError("Mission event actors come from the agent credential.",{code:"INVALID_EVENT"});return(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/events`,{...options,body:input,idempotencyKey:options.idempotencyKey??idempotencyKey()})).data},ack:async(id,eventId,options)=>(await this.#transport.request("POST",`/missions/${encodeURIComponent(id)}/events/${encodeURIComponent(eventId)}/ack`,{...options,body:{},retrySafe:true})).data}};chats={list:(query={},options)=>this.#transport.request("GET","/chats",{...options,query}),get:async(id,options={})=>(await this.#transport.request("GET",`/chats/${encodeURIComponent(id)}`,{signal:options.signal,query:{cursor:options.cursor,before:options.before,limit:options.limit}})).data,updates:async(id,text,options={})=>(await this.#transport.request("POST",`/chats/${encodeURIComponent(id)}/updates`,{...options,body:{text},idempotencyKey:options.idempotencyKey??idempotencyKey()})).data};chatCommands={list:(query={},options)=>this.#transport.request("GET","/chat-commands",{...options,query}),claim:async(id,options)=>(await this.#transport.request("POST",`/chat-commands/${encodeURIComponent(id)}/claim`,{...options,body:{}})).data,renew:async(id,leaseToken,options)=>(await this.#transport.request("POST",`/chat-commands/${encodeURIComponent(id)}/renew`,{...options,body:{leaseToken},retrySafe:true})).data,complete:async(id,input,options={})=>(await this.#transport.request("POST",`/chat-commands/${encodeURIComponent(id)}/complete`,{...options,body:input,idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,fail:async(id,input,options)=>(await this.#transport.request("POST",`/chat-commands/${encodeURIComponent(id)}/fail`,{...options,body:input,retrySafe:true})).data};runtime={activations:async options=>(await this.#transport.request("GET","/runtime/activations",options)).data,reportActivation:async(input,options)=>(await this.#transport.request("POST","/runtime/activations",{...options,body:input,retrySafe:true})).data,start:async(input,options)=>(await this.#transport.request("POST","/runtime/start",{...options,body:input,retrySafe:true})).data,probe:async(runId,options)=>(await this.#transport.request("GET","/runtime/probe",{...options,query:{runId}})).data,replyProbe:async(input,options)=>(await this.#transport.request("POST","/runtime/probe",{...options,body:input,retrySafe:true})).data,heartbeat:async(input={},options)=>(await this.#transport.request("POST","/runtime/heartbeat",{...options,body:input,retrySafe:true})).data};tasks={create:async(input,options={})=>(await this.#transport.request("POST","/tasks",{...options,body:{to:input.to,content:content(input),conversationId:input.conversationId,metadata:input.metadata,ttlSeconds:input.ttlSeconds,authorization:input.authorization},idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,get:async(id,options)=>(await this.#transport.request("GET",`/tasks/${encodeURIComponent(id)}`,options)).data,list:(query={},options)=>this.#transport.request("GET","/tasks",{...options,query}),iterate:(query={},options)=>paginate(cursor=>this.tasks.list({...query,cursor},options),query.cursor),postUpdate:async(id,text,options={})=>(await this.#transport.request("POST",`/tasks/${encodeURIComponent(id)}/messages`,{...options,body:{content:{type:"text",text}},idempotencyKey:options.idempotencyKey??idempotencyKey()})).data,update:async(id,input,options)=>(await this.#transport.request("PATCH",`/tasks/${encodeURIComponent(id)}`,{...options,body:input})).data,cancel:async(id,options)=>(await this.#transport.request("POST",`/tasks/${encodeURIComponent(id)}/cancel`,{...options,body:{}})).data};repositories={getTask:async(taskId,options)=>(await this.#transport.request("GET",`/tasks/${encodeURIComponent(taskId)}/repository`,options)).data,claim:async(taskId,input,options)=>(await this.#transport.request("POST",`/tasks/${encodeURIComponent(taskId)}/repository`,{...options,body:input})).data,update:async(taskId,input,options)=>(await this.#transport.request("PATCH",`/tasks/${encodeURIComponent(taskId)}/repository`,{...options,body:input})).data};github={repositories:async options=>(await this.#transport.request("GET","/github/repositories",options)).data,openPullRequest:async(taskId,input,options)=>(await this.#transport.request("POST",`/github/pull-requests?taskId=${encodeURIComponent(taskId)}`,{...options,body:input})).data}}class ConversationHandle{id;conversation;#totem;#recipient;constructor(totem,conversation,recipient){this.#totem=totem;this.conversation=conversation;this.id=conversation.id;this.#recipient=recipient}send(text,options){return this.#totem.messages.send({to:this.#recipient,text,conversationId:this.id},options)}messages(query={},options){return this.#totem.conversations.messages(this.id,query,options)}}class ConnectedAgent{identity;address;client;#subscription;#lastError;constructor(client,identity){this.client=client;this.identity=identity;this.address=identity.address}get lastError(){return this.#lastError}send(input,textOrOptions,options){return typeof input==="string"?this.client.send(input,textOrOptions,options):this.client.send(input,textOrOptions)}startConversation(input){return this.client.startConversation(input)}on(event,handler,options={}){if(event!=="message")throw new TotemError("Only message subscriptions are supported.",{code:"INVALID_EVENT"});if(this.#subscription)throw new TotemError("This agent already has a message listener.",{code:"ALREADY_LISTENING"});const interval=options.pollIntervalMs??1e3;if(!Number.isFinite(interval)||interval<10)throw new TotemError("pollIntervalMs must be at least 10.",{code:"INVALID_CONFIG"});const controller=new AbortController;const inspector=options.inspector??createLocalInspector();const blocked=new Set;const report=cause=>{this.#lastError=cause instanceof Error?cause:new Error(String(cause));try{options.onError?.(this.#lastError)}catch{}};const done=(async()=>{while(!controller.signal.aborted){try{for await(const message of this.client.messages.iterate({direction:"inbound",unread:true,limit:100},{signal:controller.signal})){if(controller.signal.aborted)break;if(blocked.has(message.id))continue;try{if(message.content.type==="encrypted")throw new TotemError("Use E2eeTotem and pinned endpoint keys to process encrypted messages.",{code:"E2EE_CLIENT_REQUIRED"});await inspector.assertAllowed("input",{content:message.content,metadata:message.metadata??{}},{signal:controller.signal});const files=message.attachments??[];const ids=new Set(files.map(file=>file.id));if(message.content.type==="text"&&message.content.attachments?.some(id=>!ids.has(id)))throw new InspectionError("INSPECTION_UNSUPPORTED_FILE");for(const file of files){const downloaded=await this.client.attachments.download(file.id,{signal:controller.signal});await inspector.inspectFile(file.name,file.mediaType,downloaded.bytes,{signal:controller.signal})}const incoming={...message,text:message.content.type==="text"?message.content.text:JSON.stringify(message.content.data),reply:(text,writeOptions={})=>inspector.runAction({id:message.id,text},input=>this.client.messages.reply(input.id,input.text,{...writeOptions,idempotencyKey:writeOptions.idempotencyKey??`reply:${message.id}:0`}),{signal:controller.signal}),ack:()=>this.client.messages.ack(message.id)};await handler(incoming);await incoming.ack()}catch(error){if(error instanceof InspectionError&&error.code!=="INSPECTION_UNAVAILABLE")blocked.add(message.id);report(error)}}}catch(error){if(!controller.signal.aborted)report(error)}if(!controller.signal.aborted){try{await sleep(interval,controller.signal)}catch{}}}})();const subscription={done,stop:async()=>{controller.abort();await done;if(this.#subscription===subscription)this.#subscription=void 0}};this.#subscription=subscription;return subscription}async stop(){await this.#subscription?.stop()}}class TotemAgent extends Totem{}export{ConnectedAgent,ConversationHandle,InspectionError,Totem,TotemAgent,createLocalInspector,idempotencyKey2 as idempotencyKey};