@ziggs-ai/api-client 0.6.0 → 0.6.1

package/dist/http/ArtifactsClient.d.ts

@@ -36,6 +36,22 @@ export interface WriteArtifactInput {
  * writes. `visibility: 'agent-private'` is the new home for agent thoughts —
  * they persist, are searchable, but are not visible to other chat parties.
  */
+/**
+ * ZIG-1032 — turn a runtime lane id into a scope the backend can accept.
+ *
+ * A task with no origin chat runs on the lane `agrn-<agreementId>` (see
+ * AgentHost.laneSessionIdForTask). That is a routing key, not a chat: no such
+ * chat row exists, so passing it as `chatId` made every breadcrumb and recorded
+ * thought on an agreement lane come back 403 "not authorized for this scope" —
+ * a fictional scope reading like an auth failure. The work is agreement-scoped,
+ * so say so; same rule ZIG-924 settled for deliverables.
+ */
+export declare const AGREEMENT_LANE_PREFIX = "agrn-";
+export declare function artifactScopeForSession(sessionId: string): {
+    chatId: string;
+} | {
+    agreementId: string;
+};
 export declare class ArtifactsClient {
     private readonly operatorKey;
     private readonly agentId?;
@@ -54,7 +70,7 @@ export declare class ArtifactsClient {
      * endpoint is updated to accept `visibility`, this falls back to logging
      * locally (operators can still wire their own sink).
      */
-    recordThought(chatId: string, text: string, opts?: {
+    recordThought(sessionId: string, text: string, opts?: {
         idempotencyKey?: string;
     }): Promise<void>;
     write(input: WriteArtifactInput): Promise<void>;

package/dist/http/ArtifactsClient.js

@@ -7,6 +7,23 @@ import { buildOperatorHeaders } from './operatorHeaders.js';
  * writes. `visibility: 'agent-private'` is the new home for agent thoughts —
  * they persist, are searchable, but are not visible to other chat parties.
  */
+/**
+ * ZIG-1032 — turn a runtime lane id into a scope the backend can accept.
+ *
+ * A task with no origin chat runs on the lane `agrn-<agreementId>` (see
+ * AgentHost.laneSessionIdForTask). That is a routing key, not a chat: no such
+ * chat row exists, so passing it as `chatId` made every breadcrumb and recorded
+ * thought on an agreement lane come back 403 "not authorized for this scope" —
+ * a fictional scope reading like an auth failure. The work is agreement-scoped,
+ * so say so; same rule ZIG-924 settled for deliverables.
+ */
+export const AGREEMENT_LANE_PREFIX = 'agrn-';
+export function artifactScopeForSession(sessionId) {
+    if (sessionId.startsWith(AGREEMENT_LANE_PREFIX)) {
+        return { agreementId: sessionId.slice(AGREEMENT_LANE_PREFIX.length) };
+    }
+    return { chatId: sessionId };
+}
 export class ArtifactsClient {
     operatorKey;
     agentId;
@@ -49,9 +66,10 @@ export class ArtifactsClient {
      * endpoint is updated to accept `visibility`, this falls back to logging
      * locally (operators can still wire their own sink).
      */
-    async recordThought(chatId, text, opts = {}) {
+    async recordThought(sessionId, text, opts = {}) {
+        // ZIG-1032: `sessionId` may be an agreement lane, which is not a chat.
         return this.write({
-            chatId,
+            ...artifactScopeForSession(sessionId),
             text,
             content_type: 'thought',
             visibility: 'agent-private',

package/dist/http/index.d.ts

@@ -5,7 +5,7 @@ export * from './agreementFlows.js';
 export * from './ChatClient.js';
 export { MessagesClient } from './MessagesClient.js';
 export type { ListMessagesOptions, ListMessagesResult } from './MessagesClient.js';
-export { ArtifactsClient } from './ArtifactsClient.js';
+export { ArtifactsClient, artifactScopeForSession, AGREEMENT_LANE_PREFIX, } from './ArtifactsClient.js';
 export type { ArtifactVisibility, ListArtifactsOptions, ListArtifactsQuery, ListArtifactsResult, WriteArtifactInput, } from './ArtifactsClient.js';
 export { ContextReadClient } from './ContextReadClient.js';
 export type { ContextReadType, ContextReadQuery, ContextReadEnvelope, ContextSnapshotResult, } from './ContextReadClient.js';

package/dist/http/index.js

@@ -4,7 +4,9 @@ export * from './MarketplaceClient.js';
 export * from './agreementFlows.js';
 export * from './ChatClient.js';
 export { MessagesClient } from './MessagesClient.js';
-export { ArtifactsClient } from './ArtifactsClient.js';
+export { ArtifactsClient, 
+// ZIG-1032: agreement lanes are not chats — callers scope artifact writes with this.
+artifactScopeForSession, AGREEMENT_LANE_PREFIX, } from './ArtifactsClient.js';
 export { ContextReadClient } from './ContextReadClient.js';
 export { ContextDiscoveryClient } from './ContextDiscoveryClient.js';
 export { GrantsClient } from './GrantsClient.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ziggs-ai/api-client",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",