@harness-gw/sdk 0.5.0 → 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.5.0 \
+     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.5.0 \
+     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/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

@@ -60,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,9 +23,9 @@ 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;
@@ -35,9 +35,9 @@ 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;
@@ -48,14 +48,14 @@ 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;
@@ -64,7 +64,6 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
     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;
@@ -76,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[];
@@ -126,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";
@@ -208,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";
@@ -227,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;
@@ -280,6 +280,7 @@ export declare function createAcpWorkspaceClient({ connection, rest, agentIdFor,
     } | undefined;
     models: (sessionId: string) => {
         selectedId: string;
+        effortId?: string | undefined;
         options: {
             id: string;
             label: string;
@@ -289,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;
@@ -314,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;
@@ -323,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;
@@ -336,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>;
@@ -344,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";
@@ -469,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: {};