totemlayer 0.1.24 → 0.1.29

package/bin/sdk/actions.js

@@ -1,84 +1 @@
-import { TotemError } from "./errors.js";
-import { requireActionChecksKey, signalOnlyOptions } from "./request-options.js";
-import { Transport } from "./transport.js";
-export * from "./action-types.js";
-function responseField(payload, key) {
-    const value = payload[key];
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        throw new TotemError("Totem returned an invalid Action Checks response.", {
-            code: "INVALID_RESPONSE",
-        });
-    }
-    return value;
-}
-function proposal(action) {
-    const authorityFields = [
-        "organizationId",
-        "userId",
-        "ownerUserId",
-        "requestedByUserId",
-        "requestedByApiKeyId",
-        "principal",
-        "authentication",
-        "apiKeyId",
-        "from",
-    ];
-    if (!action || typeof action !== "object" || authorityFields.some((key) => key in action)) {
-        throw new TotemError("Action Checks caller authority comes from its separate scoped API key.", {
-            code: "INVALID_ACTION",
-        });
-    }
-    return action;
-}
-/**
- * Separately authenticated Action Checks client. Human approval stays in Totem's UI.
- * Writes are never automatically replayed, even when the action has an idempotency key.
- * After an ambiguous execution failure, use get() to inspect the receipt before proceeding.
- */
-export class TotemActions {
-    #transport;
-    constructor(options) {
-        this.#transport = new Transport({
-            apiKey: requireActionChecksKey(options.actionChecksApiKey),
-            baseUrl: options.baseUrl,
-            timeoutMs: options.timeoutMs,
-            maxRetries: options.maxRetries,
-            retryDelayMs: options.retryDelayMs,
-            fetch: options.fetch,
-        }, { basePath: "/api/action-checks", responseEnvelope: "object" });
-    }
-    async create(action, options) {
-        const result = await this.#transport.request("POST", "", {
-            ...signalOnlyOptions(options),
-            body: { action: proposal(action) },
-        });
-        return responseField(result, "suite");
-    }
-    async get(suiteId, options) {
-        const result = await this.#transport.request("GET", `/${encodeURIComponent(suiteId)}`, signalOnlyOptions(options));
-        return responseField(result, "suite");
-    }
-    async issueGrant(suiteId, action, options) {
-        const result = await this.#transport.request("POST", `/${encodeURIComponent(suiteId)}/grant`, {
-            ...signalOnlyOptions(options),
-            body: { action: proposal(action) },
-        });
-        return responseField(result, "grant");
-    }
-    async execute(suiteId, input, options) {
-        const result = await this.#transport.request("POST", `/${encodeURIComponent(suiteId)}/execute`, {
-            ...signalOnlyOptions(options),
-            body: { action: proposal(input.action), grant: input.grant },
-        });
-        const suite = responseField(result, "suite");
-        const receipt = result.receipt === null
-            ? null
-            : responseField(result, "receipt");
-        if (typeof result.receiptId !== "string" || !result.receiptId) {
-            throw new TotemError("Totem returned an invalid execution receipt ID.", {
-                code: "INVALID_RESPONSE",
-            });
-        }
-        return { suite, receipt, receiptId: result.receiptId };
-    }
-}
+import{TotemError}from"./errors.js";import{requireActionChecksKey,signalOnlyOptions}from"./request-options.js";import{Transport}from"./transport.js";export*from"./action-types.js";function responseField(payload,key){const value=payload[key];if(!value||typeof value!=="object"||Array.isArray(value)){throw new TotemError("Totem returned an invalid Action Checks response.",{code:"INVALID_RESPONSE"})}return value}function proposal(action){const authorityFields=["organizationId","userId","ownerUserId","requestedByUserId","requestedByApiKeyId","principal","authentication","apiKeyId","from"];if(!action||typeof action!=="object"||authorityFields.some(key=>key in action)){throw new TotemError("Action Checks caller authority comes from its separate scoped API key.",{code:"INVALID_ACTION"})}return action}class TotemActions{#transport;constructor(options){this.#transport=new Transport({apiKey:requireActionChecksKey(options.actionChecksApiKey),baseUrl:options.baseUrl,timeoutMs:options.timeoutMs,maxRetries:options.maxRetries,retryDelayMs:options.retryDelayMs,fetch:options.fetch},{basePath:"/api/action-checks",responseEnvelope:"object"})}async create(action,options){const result=await this.#transport.request("POST","",{...signalOnlyOptions(options),body:{action:proposal(action)}});return responseField(result,"suite")}async get(suiteId,options){const result=await this.#transport.request("GET",`/${encodeURIComponent(suiteId)}`,signalOnlyOptions(options));return responseField(result,"suite")}async issueGrant(suiteId,action,options){const result=await this.#transport.request("POST",`/${encodeURIComponent(suiteId)}/grant`,{...signalOnlyOptions(options),body:{action:proposal(action)}});return responseField(result,"grant")}async execute(suiteId,input,options){const result=await this.#transport.request("POST",`/${encodeURIComponent(suiteId)}/execute`,{...signalOnlyOptions(options),body:{action:proposal(input.action),grant:input.grant}});const suite=responseField(result,"suite");const receipt=result.receipt===null?null:responseField(result,"receipt");if(typeof result.receiptId!=="string"||!result.receiptId){throw new TotemError("Totem returned an invalid execution receipt ID.",{code:"INVALID_RESPONSE"})}return{suite,receipt,receiptId:result.receiptId}}}export{TotemActions};

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: {
@@ -195,6 +227,8 @@ export declare class Totem {
         }>;
     };
     runtime: {
+        activations: (options?: RequestOptions) => Promise<{ data: Array<{ id: string; state: string; ready: boolean }> }>;
+        reportActivation: (input: { id: string; state: "starting" | "ready" | "blocked" | "paused"; errorCode?: "READINESS_UNSUPPORTED" | "LISTENER_START_FAILED" | "AUTHORIZATION_REJECTED" }, options?: RequestOptions) => Promise<{ recorded: boolean }>;
         start: (input: {
             runId: string;
             provider: string;
@@ -233,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>;