@harness-gw/sdk 0.4.1 → 0.5.1

package/README.md

@@ -63,7 +63,7 @@ You need a running harness. Hermes is the primary one; see
    docker run --rm \
      -v "$PWD/config.yaml:/run/harness-gw/config.yaml:ro" \
      -v "$PWD/hermes-token:/run/secrets/hermes-token:ro" \
-     ghcr.io/almogbaku/harness-gw:0.4.1 \
+     ghcr.io/almogbaku/harness-gw:0.5.1 \
      config check --config /run/harness-gw/config.yaml
    ```
 
@@ -73,7 +73,7 @@ You need a running harness. Hermes is the primary one; see
    docker run --rm -p 127.0.0.1:4100:4100 \
      -v "$PWD/config.yaml:/run/harness-gw/config.yaml:ro" \
      -v "$PWD/hermes-token:/run/secrets/hermes-token:ro" \
-     ghcr.io/almogbaku/harness-gw:0.4.1 \
+     ghcr.io/almogbaku/harness-gw:0.5.1 \
      serve --config /run/harness-gw/config.yaml
    ```
 
@@ -156,8 +156,9 @@ Use [Bun](https://bun.sh).
 
 ```bash
 bun install
-bun run typecheck
-bun run lint
+bun run typecheck   # TypeScript 7
+bun run lint        # Oxlint, type-aware
+bun run format      # oxfmt
 bun run test        # unit and integration
 bun run test:gate   # build and packaging checks
 bun run build       # the SDK's dist/

package/dist/chunks/index.js

@@ -84,7 +84,8 @@ var AgentSummarySchema = z.strictObject({
   activity: z.enum(["active", "idle", "unknown"]).optional(),
   visibility: z.enum(["visible", "hidden"]).optional(),
   role: z.literal("creator").optional(),
-  avatar: AgentAvatarSchema2.optional()
+  avatar: AgentAvatarSchema2.optional(),
+  muted: z.literal(true).optional()
 });
 var AgentCatalogEntrySchema2 = z.strictObject({
   summary: AgentSummarySchema,
@@ -92,6 +93,7 @@ var AgentCatalogEntrySchema2 = z.strictObject({
   selectable: z.boolean(),
   editable: z.boolean(),
   avatarEditable: z.boolean(),
+  muteEditable: z.boolean(),
   revision: IdentifierSchema
 });
 var AgentCatalogResponseSchema2 = z.strictObject({
@@ -101,12 +103,13 @@ var AgentCatalogResponseSchema2 = z.strictObject({
 var AgentUpdateFields2 = {
   visibility: z.enum(["visible", "hidden"]).optional(),
   avatar: AgentAvatarSchema2.nullable().optional(),
+  muted: z.boolean().optional(),
   revision: IdentifierSchema
 };
 function writesAgentField2(value) {
-  return value.visibility !== undefined || value.avatar !== undefined;
+  return value.visibility !== undefined || value.avatar !== undefined || value.muted !== undefined;
 }
-var AgentUpdateRequestSchema2 = z.strictObject(AgentUpdateFields2).refine(writesAgentField2, "At least one of visibility, avatar");
+var AgentUpdateRequestSchema2 = z.strictObject(AgentUpdateFields2).refine(writesAgentField2, "At least one of visibility, avatar, muted");
 var AgentUpdateResponseSchema2 = z.strictObject({
   revision: IdentifierSchema,
   agent: AgentCatalogEntrySchema2
@@ -842,7 +845,7 @@ var HgwFocusRequestSchema2 = z2.strictObject({
   idle: z2.boolean().optional()
 });
 var HgwAgentsListResponseSchema2 = AgentCatalogResponseSchema2;
-var HgwAgentUpdateRequestSchema2 = z2.strictObject({ agentId: IdentifierSchema2, ...AgentUpdateFields2 }).refine(writesAgentField2, "At least one of visibility, avatar");
+var HgwAgentUpdateRequestSchema2 = z2.strictObject({ agentId: IdentifierSchema2, ...AgentUpdateFields2 }).refine(writesAgentField2, "At least one of visibility, avatar, muted");
 var HgwAgentUpdateResponseSchema2 = AgentUpdateResponseSchema2;
 var TurnMetaBase = {
   sequence: SequenceSchema,
@@ -980,10 +983,12 @@ var HgwErrorNotificationSchema2 = readObject({
   code: z2.string().min(1).max(128),
   message: z2.string().max(4096)
 });
+var HGW_REQUEST_TEXT_MAX2 = 200;
 var ActivityBase = {
   agentId: IdentifierSchema2,
   sessionId: IdentifierSchema2,
-  occurredAt: z2.iso.datetime()
+  occurredAt: z2.iso.datetime(),
+  replayed: z2.literal(true).optional()
 };
 var HgwActivityNotificationSchema2 = z2.discriminatedUnion("type", [
   readObject({
@@ -995,7 +1000,9 @@ var HgwActivityNotificationSchema2 = z2.discriminatedUnion("type", [
     ...ActivityBase,
     type: z2.literal("attention-requested"),
     requestId: IdentifierSchema2,
-    attentionKind: z2.enum(["question", "permission"])
+    attentionKind: z2.enum(["question", "permission"]),
+    requestText: z2.string().min(1).max(HGW_REQUEST_TEXT_MAX2).optional(),
+    requestMore: z2.number().int().min(1).optional()
   }),
   readObject({
     ...ActivityBase,
@@ -1036,15 +1043,24 @@ var COALESCE_WINDOW_MS2 = {
   failure: 5000,
   completion: 20000
 };
+var PUSH_TEXT_LIMITS2 = {
+  agentName: 64,
+  sessionTitle: 120,
+  requestText: HGW_REQUEST_TEXT_MAX2
+};
+var pushText = (max) => z3.string().min(1).max(max);
 var PushMessageSchema2 = z3.strictObject({
-  v: z3.literal(1),
+  v: z3.literal(2),
   category: PushCategorySchema2,
-  count: z3.number().int().min(1),
-  agentId: IdentifierSchema2.optional(),
-  sessionId: IdentifierSchema2.optional(),
+  agentId: IdentifierSchema2,
+  sessionId: IdentifierSchema2,
   occurredAt: z3.iso.datetime(),
-  locale: PushLocaleSchema2
-}).refine((message) => message.count === 1 === (message.agentId !== undefined && message.sessionId !== undefined), { message: "A single-Session push carries both ids; a count carries none" });
+  locale: PushLocaleSchema2,
+  agentName: pushText(PUSH_TEXT_LIMITS2.agentName).optional(),
+  sessionTitle: pushText(PUSH_TEXT_LIMITS2.sessionTitle).optional(),
+  requestText: pushText(PUSH_TEXT_LIMITS2.requestText).optional(),
+  requestMore: z3.number().int().min(1).optional()
+});
 var PushCategoriesSchema2 = z3.strictObject({
   input: z3.boolean(),
   failure: z3.boolean(),
@@ -1164,4 +1180,4 @@ var MCP_APP_SANDBOX_CSP2 = [
   "frame-ancestors 'self'"
 ].join("; ");
 
-export { SESSION_CATALOG_MAX_WINDOW2, RuntimeAuthStateSchema2, OperationCapabilitySchema2, RuntimeInfoSchema2, AgentAvatarSchema2, AgentCatalogEntrySchema2, AgentCatalogResponseSchema2, AgentUpdateFields2, writesAgentField2, AgentUpdateRequestSchema2, AgentUpdateResponseSchema2, SessionStatusSchema2, SessionPlatformSchema2, SessionSchema2, newestSessionFirst2, SessionCatalogResponseSchema2, StopReason2, ToolKind2, ToolLocationSchema2, DiffOperation2, DiffChangeSchema2, ToolDiffSchema2, SessionMessageErrorStatusSchema2, SessionMessageSchema2, SessionPlanActivityMessageSchema2, SessionHistoryResponseSchema2, SessionCreateRequestSchema2, SessionCreateResponseSchema2, SessionPatchRequestSchema2, TurnStopResponseSchema2, TurnSteerRequestSchema2, TurnSteerResponseSchema2, SlashCommandSchema2, MAX_SLASH_COMMANDS2, INTERACTION_PROTOCOL2, SessionWorkspaceCapabilitiesResponseSchema2, GuestRuntimeCapabilitiesResponseSchema2, SessionModelsResponseSchema2, SessionModelUpdateRequestSchema2, SessionModelUpdateResponseSchema2, SessionContextResponseSchema2, ArtifactDescriptorSchema2, SessionTodosResponseSchema2, SessionActivityResponseSchema2, SessionAttachmentStageRequestSchema2, SessionAttachmentStageResponseSchema2, SessionAudioResponseSchema2, SessionTranscriptionRequestSchema2, SessionTranscriptionResponseSchema2, SessionSpeechRequestSchema2, ErrorResponseSchema2, ACP_PROTOCOL_VERSION2, HGW_API_PREFIX2, HGW_ACP_PATH2, HGW_ACP_AGENTS_PATH2, hgwAcpAgentPath2, HGW_META_KEY2, HGW_EXTENSION_VERSION2, HGW_AUTH_METHOD_INVITE2, HGW_ATTACHMENT_URI_SCHEME2, HGW_ARTIFACT_URI_SCHEME2, HGW_METHODS2, HGW_STOP_REASONS2, HGW_PERMISSION_KIND_SESSION2, HGW_PLAN_ID2, HGW_JSONRPC_ERRORS2, IdentifierSchema2, HgwExtensionsSchema2, HgwClientCapabilitiesMetaSchema2, HgwInitializeMetaSchema2, HgwLoginMetaSchema2, HgwSessionNewMetaSchema2, HgwSessionListMetaSchema2, HgwSessionSearchMetaSchema2, HgwSessionSearchResponseSchema2, HgwSessionInfoMetaSchema2, HgwSessionResumeMetaSchema2, HGW_REPLAY_BEFORE2, HgwReplayBeforeSchema2, HgwHistoryCursorSchema2, HgwHistoryPageResponseMetaSchema2, HgwHistoryPageTagSchema2, HgwSessionResumeResponseMetaSchema2, HgwPromptMetaSchema2, HgwSessionUpdateRequestSchema2, HgwSessionPartRequestSchema2, HgwSteerRequestSchema2, HgwSteerResponseSchema2, HgwFocusRequestSchema2, HgwAgentsListResponseSchema2, HgwAgentUpdateRequestSchema2, HgwAgentUpdateResponseSchema2, HgwTurnMetaSchema2, HgwNoticeMetaSchema2, HgwMessageMetaSchema2, HgwCostSchema2, HGW_SUBAGENT_STATUSES2, HgwSubagentSchema2, HgwStateMetaSchema2, HgwChunkMetaSchema2, HgwToolCallMetaSchema2, HgwPlanMetaSchema2, HgwUsageMetaSchema2, HgwAvailableCommandsMetaSchema2, HgwPermissionMetaSchema2, HgwQuestionOptionSchema2, HgwQuestionSchema2, HgwElicitationMetaSchema2, HgwArtifactDescriptorSchema2, formatArtifactUri2, parseArtifactUri2, HgwComposerPrefillNotificationSchema2, HgwErrorNotificationSchema2, HgwActivityNotificationSchema2, PushCategorySchema2, categoryOf2, PushLocaleSchema2, PRESENCE_IDLE_MS2, PRESENCE_HEARTBEAT_MS2, PRESENCE_GRACE_MS2, PRESENCE_CLOSED_GRACE_MS2, COALESCE_WINDOW_MS2, PushMessageSchema2, PushCategoriesSchema2, PushSubscriptionJsonSchema2, PushInfoSchema2, PushRegistrationSchema2, PushUnregistrationSchema2, CallToolResultSchema2, ReadResourceResultSchema2, McpUiCspSchema2, isMcpAppCspDomain2, McpUiPermissionsSchema2, McpAppFilesSchema2, McpAppViewSchema2, viewerFileResult2, McpAppToolCallRequestSchema2, McpAppResourceReadRequestSchema2, MCP_APP_SANDBOX_PATH2, MCP_APP_SANDBOX_CSP2 };
+export { SESSION_CATALOG_MAX_WINDOW2, RuntimeAuthStateSchema2, OperationCapabilitySchema2, RuntimeInfoSchema2, AgentAvatarSchema2, AgentCatalogEntrySchema2, AgentCatalogResponseSchema2, AgentUpdateFields2, writesAgentField2, AgentUpdateRequestSchema2, AgentUpdateResponseSchema2, SessionStatusSchema2, SessionPlatformSchema2, SessionSchema2, newestSessionFirst2, SessionCatalogResponseSchema2, StopReason2, ToolKind2, ToolLocationSchema2, DiffOperation2, DiffChangeSchema2, ToolDiffSchema2, SessionMessageErrorStatusSchema2, SessionMessageSchema2, SessionPlanActivityMessageSchema2, SessionHistoryResponseSchema2, SessionCreateRequestSchema2, SessionCreateResponseSchema2, SessionPatchRequestSchema2, TurnStopResponseSchema2, TurnSteerRequestSchema2, TurnSteerResponseSchema2, SlashCommandSchema2, MAX_SLASH_COMMANDS2, INTERACTION_PROTOCOL2, SessionWorkspaceCapabilitiesResponseSchema2, GuestRuntimeCapabilitiesResponseSchema2, SessionModelsResponseSchema2, SessionModelUpdateRequestSchema2, SessionModelUpdateResponseSchema2, SessionContextResponseSchema2, ArtifactDescriptorSchema2, SessionTodosResponseSchema2, SessionActivityResponseSchema2, SessionAttachmentStageRequestSchema2, SessionAttachmentStageResponseSchema2, SessionAudioResponseSchema2, SessionTranscriptionRequestSchema2, SessionTranscriptionResponseSchema2, SessionSpeechRequestSchema2, ErrorResponseSchema2, ACP_PROTOCOL_VERSION2, HGW_API_PREFIX2, HGW_ACP_PATH2, HGW_ACP_AGENTS_PATH2, hgwAcpAgentPath2, HGW_META_KEY2, HGW_EXTENSION_VERSION2, HGW_AUTH_METHOD_INVITE2, HGW_ATTACHMENT_URI_SCHEME2, HGW_ARTIFACT_URI_SCHEME2, HGW_METHODS2, HGW_STOP_REASONS2, HGW_PERMISSION_KIND_SESSION2, HGW_PLAN_ID2, HGW_JSONRPC_ERRORS2, IdentifierSchema2, HgwExtensionsSchema2, HgwClientCapabilitiesMetaSchema2, HgwInitializeMetaSchema2, HgwLoginMetaSchema2, HgwSessionNewMetaSchema2, HgwSessionListMetaSchema2, HgwSessionSearchMetaSchema2, HgwSessionSearchResponseSchema2, HgwSessionInfoMetaSchema2, HgwSessionResumeMetaSchema2, HGW_REPLAY_BEFORE2, HgwReplayBeforeSchema2, HgwHistoryCursorSchema2, HgwHistoryPageResponseMetaSchema2, HgwHistoryPageTagSchema2, HgwSessionResumeResponseMetaSchema2, HgwPromptMetaSchema2, HgwSessionUpdateRequestSchema2, HgwSessionPartRequestSchema2, HgwSteerRequestSchema2, HgwSteerResponseSchema2, HgwFocusRequestSchema2, HgwAgentsListResponseSchema2, HgwAgentUpdateRequestSchema2, HgwAgentUpdateResponseSchema2, HgwTurnMetaSchema2, HgwNoticeMetaSchema2, HgwMessageMetaSchema2, HgwCostSchema2, HGW_SUBAGENT_STATUSES2, HgwSubagentSchema2, HgwStateMetaSchema2, HgwChunkMetaSchema2, HgwToolCallMetaSchema2, HgwPlanMetaSchema2, HgwUsageMetaSchema2, HgwAvailableCommandsMetaSchema2, HgwPermissionMetaSchema2, HgwQuestionOptionSchema2, HgwQuestionSchema2, HgwElicitationMetaSchema2, HgwArtifactDescriptorSchema2, formatArtifactUri2, parseArtifactUri2, HgwComposerPrefillNotificationSchema2, HgwErrorNotificationSchema2, HGW_REQUEST_TEXT_MAX2, HgwActivityNotificationSchema2, PushCategorySchema2, categoryOf2, PushLocaleSchema2, PRESENCE_IDLE_MS2, PRESENCE_HEARTBEAT_MS2, PRESENCE_GRACE_MS2, PRESENCE_CLOSED_GRACE_MS2, COALESCE_WINDOW_MS2, PUSH_TEXT_LIMITS2, PushMessageSchema2, PushCategoriesSchema2, PushSubscriptionJsonSchema2, PushInfoSchema2, PushRegistrationSchema2, PushUnregistrationSchema2, CallToolResultSchema2, ReadResourceResultSchema2, McpUiCspSchema2, isMcpAppCspDomain2, McpUiPermissionsSchema2, McpAppFilesSchema2, McpAppViewSchema2, viewerFileResult2, McpAppToolCallRequestSchema2, McpAppResourceReadRequestSchema2, MCP_APP_SANDBOX_PATH2, MCP_APP_SANDBOX_CSP2 };

package/dist/client/acp-workspace-client-composer.d.ts

@@ -32,15 +32,15 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
     capabilities: (sessionId: string) => {
         workspace: {
             slashCommands: {
-                status: "unavailable";
-                reason: string;
-            } | {
                 status: "available";
                 scope: "session";
                 commands: {
                     name: string;
                     description?: string | undefined;
                 }[];
+            } | {
+                status: "unavailable";
+                reason: string;
             };
             models: {
                 status: "unavailable";
@@ -114,7 +114,7 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
                 protocol: "acp-request";
                 scope: "turn";
                 answerModes: ["single", "multiple", "free-text"];
-                cancellation: "native-empty-answer" | "native-reject" | "native-cancel";
+                cancellation: "native-cancel" | "native-empty-answer" | "native-reject";
                 maxQuestions: number;
                 maxChoicesPerQuestion: number;
                 maxAnswerValuesPerQuestion: number | "complete-request";
@@ -133,7 +133,7 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
                 status: "available";
                 scope: "session";
                 inputs: ["image", "file"];
-                imageMimeTypes: string[] | "provider-dependent";
+                imageMimeTypes: "provider-dependent" | string[];
                 fileMimeTypes: "provider-dependent" | "valid-type/subtype";
                 maxMimeTypeBytes: number;
                 maxFilenameBytes: number;
@@ -186,6 +186,7 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
     } | undefined;
     models: (sessionId: string) => {
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -195,14 +196,13 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
                 name?: string | undefined;
             }[] | undefined;
         }[];
-        effortId?: string | undefined;
     } | undefined;
     /** The newest reading, or none while the provider has reported none. */
     context: (sessionId: string) => {
         usedTokens: number;
         maxTokens: number;
-        source: "provider-usage" | "provider-usage-plus-estimate" | "local-estimate";
         estimated?: true | undefined;
+        source: "local-estimate" | "provider-usage" | "provider-usage-plus-estimate";
         breakdown?: {
             systemTokens: number;
             toolTokens: number;
@@ -219,6 +219,7 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
     modelFeed: (sessionId: string) => ComposerModelFeed;
     selectModel: (sessionId: string, selectedId: string) => Promise<{
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -228,10 +229,10 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
                 name?: string | undefined;
             }[] | undefined;
         }[];
-        effortId?: string | undefined;
     }>;
     selectEffort: (sessionId: string, effortId: string) => Promise<{
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -241,6 +242,5 @@ export declare function createAcpComposerStore(connection: AcpConnection): {
                 name?: string | undefined;
             }[] | undefined;
         }[];
-        effortId?: string | undefined;
     }>;
 };

package/dist/client/acp-workspace-client-sessions.d.ts

@@ -17,6 +17,13 @@ export type AcpSessionStoreOptions = {
 export declare function createAcpSessionStore({ connection, now, onTurnFinished, }: AcpSessionStoreOptions): {
     subscribe: (sessionId: string, agentId?: string) => () => void;
     dispose(): void;
+    /**
+     * A connection that starts over re-sends every request still open as it
+     * catches up, so one the old connection left open and the new one does
+     * not name was settled while nobody was listening; and what it re-sends
+     * is no longer marked as already seen.
+     */
+    startOver(): void;
     put: (sessionId: string, info: HgwSessionInfoMeta, updatedAt?: string | null) => void;
     rowsFor: (sessionIds: Iterable<string>) => {
         sessionId: string;
@@ -53,12 +60,12 @@ export declare function rowOf(session: SessionInfo): {
     sessionId: string;
     info: {
         agentId: string;
-        status: "unknown" | "idle" | "running" | "waiting-for-input" | "failed";
+        status: "failed" | "idle" | "running" | "unknown" | "waiting-for-input";
         archived: boolean;
         createdAt?: string | undefined;
         unread?: boolean | undefined;
         pinned?: boolean | undefined;
-        platform?: "buzz" | "whatsapp" | "slack" | "telegram" | "email" | "discord" | undefined;
+        platform?: "buzz" | "discord" | "email" | "slack" | "telegram" | "whatsapp" | undefined;
     };
     updatedAt: string | null | undefined;
     title: string | null | undefined;

package/dist/client/acp-workspace-client.d.ts

@@ -23,22 +23,24 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         id: string;
         name: string;
         description?: string | undefined;
-        status?: "active" | "unknown" | "idle" | "running" | "attention" | undefined;
-        activity?: "active" | "unknown" | "idle" | undefined;
-        visibility?: "visible" | "hidden" | undefined;
+        status?: "active" | "attention" | "idle" | "running" | "unknown" | undefined;
+        activity?: "active" | "idle" | "unknown" | undefined;
+        visibility?: "hidden" | "visible" | undefined;
         role?: "creator" | undefined;
         avatar?: string | undefined;
+        muted?: true | undefined;
     }[]>;
     refreshAgents(): Promise<{
         kind: "ready";
         id: string;
         name: string;
         description?: string | undefined;
-        status?: "active" | "unknown" | "idle" | "running" | "attention" | undefined;
-        activity?: "active" | "unknown" | "idle" | undefined;
-        visibility?: "visible" | "hidden" | undefined;
+        status?: "active" | "attention" | "idle" | "running" | "unknown" | undefined;
+        activity?: "active" | "idle" | "unknown" | undefined;
+        visibility?: "hidden" | "visible" | undefined;
         role?: "creator" | undefined;
         avatar?: string | undefined;
+        muted?: true | undefined;
     }[]>;
     listAgentCatalog(): Promise<{
         summary: {
@@ -46,21 +48,22 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
             id: string;
             name: string;
             description?: string | undefined;
-            status?: "active" | "unknown" | "idle" | "running" | "attention" | undefined;
-            activity?: "active" | "unknown" | "idle" | undefined;
-            visibility?: "visible" | "hidden" | undefined;
+            status?: "active" | "attention" | "idle" | "running" | "unknown" | undefined;
+            activity?: "active" | "idle" | "unknown" | undefined;
+            visibility?: "hidden" | "visible" | undefined;
             role?: "creator" | undefined;
             avatar?: string | undefined;
+            muted?: true | undefined;
         };
-        visibility: "visible" | "hidden";
+        visibility: "hidden" | "visible";
         selectable: boolean;
         editable: boolean;
         avatarEditable: boolean;
+        muteEditable: boolean;
     }[]>;
     updateAgent: (agentId: string, patch: AgentUpdate) => Promise<void>;
     subscribeAgentCatalog: (listener: () => void) => () => void;
     listSessions: (agentId?: string, cursor?: string) => Promise<{
-        nextCursor?: string | undefined;
         sessions: {
             sessionId: string;
             agentId: string;
@@ -72,6 +75,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
             createdAt?: string;
             platform?: import("./workspace.js").SessionPlatform;
         }[];
+        nextCursor?: string | undefined;
     }>;
     readSessionPage: (meta: Parameters<AcpConnection["listSessions"]>[0], cursor?: string) => Promise<{
         sessions: SessionInfo[];
@@ -122,15 +126,15 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
     workspaceCapabilities: (sessionId: string) => {
         workspace: {
             slashCommands: {
-                status: "unavailable";
-                reason: string;
-            } | {
                 status: "available";
                 scope: "session";
                 commands: {
                     name: string;
                     description?: string | undefined;
                 }[];
+            } | {
+                status: "unavailable";
+                reason: string;
             };
             models: {
                 status: "unavailable";
@@ -204,7 +208,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
                 protocol: "acp-request";
                 scope: "turn";
                 answerModes: ["single", "multiple", "free-text"];
-                cancellation: "native-empty-answer" | "native-reject" | "native-cancel";
+                cancellation: "native-cancel" | "native-empty-answer" | "native-reject";
                 maxQuestions: number;
                 maxChoicesPerQuestion: number;
                 maxAnswerValuesPerQuestion: number | "complete-request";
@@ -223,7 +227,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
                 status: "available";
                 scope: "session";
                 inputs: ["image", "file"];
-                imageMimeTypes: string[] | "provider-dependent";
+                imageMimeTypes: "provider-dependent" | string[];
                 fileMimeTypes: "provider-dependent" | "valid-type/subtype";
                 maxMimeTypeBytes: number;
                 maxFilenameBytes: number;
@@ -276,6 +280,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
     } | undefined;
     models: (sessionId: string) => {
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -285,14 +290,13 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
                 name?: string | undefined;
             }[] | undefined;
         }[];
-        effortId?: string | undefined;
     } | undefined;
     /** The newest usage the provider pushed. */
     context: (sessionId: string) => {
         usedTokens: number;
         maxTokens: number;
-        source: "provider-usage" | "provider-usage-plus-estimate" | "local-estimate";
         estimated?: true | undefined;
+        source: "local-estimate" | "provider-usage" | "provider-usage-plus-estimate";
         breakdown?: {
             systemTokens: number;
             toolTokens: number;
@@ -310,6 +314,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
     modelFeed: (sessionId: string) => import("./workspace.js").ComposerModelFeed;
     selectModel: (sessionId: string, selectedId: string) => Promise<{
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -319,10 +324,10 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
                 name?: string | undefined;
             }[] | undefined;
         }[];
-        effortId?: string | undefined;
     }>;
     selectEffort: (sessionId: string, effortId: string) => Promise<{
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -332,7 +337,6 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
                 name?: string | undefined;
             }[] | undefined;
         }[];
-        effortId?: string | undefined;
     }>;
     /** One provider write per half; the response settles what the Session runs. */
     updateModel(sessionId: string, patch: SessionModelUpdateRequest): Promise<SessionModelUpdateResponse>;
@@ -340,14 +344,14 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
         requestId: string;
         text: string;
     }) => Promise<{
-        status: "steered" | "queued";
+        status: "queued" | "steered";
     }>;
     runtimeInfo: (signal?: AbortSignal) => Promise<{
         runtime: {
             id: string;
             name: string;
         };
-        status: "unavailable" | "ready" | "degraded";
+        status: "degraded" | "ready" | "unavailable";
         capabilities: {
             agentCatalog: {
                 status: "available";
@@ -465,8 +469,8 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
             filename?: string | undefined;
         } | {
             type: "file";
-            mimeType: string;
             filename?: string | undefined;
+            mimeType: string;
         })[];
     }>;
     readArtifact: (sessionId: string, artifactId: string, signal?: AbortSignal) => Promise<Blob>;

package/dist/client/connection.d.ts

@@ -98,15 +98,15 @@ export declare function connectionMachine({ open, handshake, recover, inProcess,
     generation: number;
     attempt: number;
 }, ConnectionEvent, {
-    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, import("xstate").NonReducibleUnknown, import("xstate").EventObject> | import("xstate").PromiseActorLogic<unknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject>> | undefined;
+    [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<unknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject> | import("xstate").PromiseActorLogic<void, import("xstate").NonReducibleUnknown, import("xstate").EventObject>> | undefined;
 }, {
-    src: "open";
-    logic: import("xstate").PromiseActorLogic<void, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
-    id: string | undefined;
-} | {
     src: "handshake";
     logic: import("xstate").PromiseActorLogic<unknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
     id: string | undefined;
+} | {
+    src: "open";
+    logic: import("xstate").PromiseActorLogic<void, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
+    id: string | undefined;
 } | {
     src: "recover";
     logic: import("xstate").PromiseActorLogic<void, import("xstate").NonReducibleUnknown, import("xstate").EventObject>;
@@ -119,6 +119,9 @@ export declare function connectionMachine({ open, handshake, recover, inProcess,
             event: string;
         }[];
     };
+} | {
+    type: "bumpGeneration";
+    params: undefined;
 } | {
     type: "clearAfter";
     params: {
@@ -127,29 +130,26 @@ export declare function connectionMachine({ open, handshake, recover, inProcess,
             event: string;
         }[];
     };
+} | {
+    type: "closeTransport";
+    params: unknown;
+} | {
+    type: "countAttempt";
+    params: undefined;
 } | {
     type: "logTransition";
     params: {
         to: string;
         info: boolean;
     };
-} | {
-    type: "bumpGeneration";
-    params: undefined;
-} | {
-    type: "closeTransport";
-    params: unknown;
-} | {
-    type: "markReady";
-    params: unknown;
 } | {
     type: "lose";
     params: {
         status: "reconnecting" | "capacity";
     };
 } | {
-    type: "countAttempt";
-    params: undefined;
+    type: "markReady";
+    params: unknown;
 } | {
     type: "resetAttempts";
     params: undefined;
@@ -162,7 +162,7 @@ export declare function connectionMachine({ open, handshake, recover, inProcess,
 } | {
     type: "tryAgainLater";
     params: unknown;
-}, "capacity" | "handshake" | "stable" | "reconnect", "ready" | "connecting" | "reconnecting" | "capacity" | "closed" | "handshaking", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+}, "capacity" | "handshake" | "reconnect" | "stable", "capacity" | "closed" | "connecting" | "handshaking" | "ready" | "reconnecting", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
     states: {
         readonly connecting: {};
         readonly handshaking: {};
@@ -209,6 +209,9 @@ export declare function sessionMachine({ join, replayOwed, oweReplay, transportL
             event: string;
         }[];
     };
+} | {
+    type: "bumpGeneration";
+    params: undefined;
 } | {
     type: "clearAfter";
     params: {
@@ -217,6 +220,9 @@ export declare function sessionMachine({ join, replayOwed, oweReplay, transportL
             event: string;
         }[];
     };
+} | {
+    type: "countAttempt";
+    params: undefined;
 } | {
     type: "logTransition";
     params: {
@@ -224,24 +230,18 @@ export declare function sessionMachine({ join, replayOwed, oweReplay, transportL
         info: boolean;
     };
 } | {
-    type: "bumpGeneration";
-    params: undefined;
-} | {
-    type: "countAttempt";
-    params: undefined;
+    type: "oweReplay";
+    params: unknown;
 } | {
     type: "resetAttempts";
     params: undefined;
-} | {
-    type: "oweReplay";
-    params: unknown;
 }, {
     type: "replayOwed";
     params: unknown;
 } | {
     type: "transportLost";
     params: unknown;
-}, "retry", "unavailable" | "joining" | "joined" | "gone" | "refused" | "detached", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
+}, "retry", "detached" | "gone" | "joined" | "joining" | "refused" | "unavailable", string, import("xstate").NonReducibleUnknown, import("xstate").NonReducibleUnknown, import("xstate").EventObject, import("xstate").MetaObject, {
     states: {
         readonly joining: {};
         readonly joined: {};