@ziggs-ai/api-client 0.10.0 → 0.10.1

package/dist/capabilities/artifacts.js

@@ -17,6 +17,10 @@ function reportingHint(env, contentType, taskId) {
     }
     return `Reporting finished work? Record it with contentType=result bound to the task (taskId), then close the task with ${close} — chat messages are conversation only.`;
 }
+/** ZIG-1320 — inline body cap + escape hatch, shared by SDK/MCP descriptions. */
+const ARTIFACT_RECORD_INLINE_CAP = 'Inline text max 50000 characters. Over that: use ziggs_artifact_upload_url ' +
+    '(file rail), or record an index artifact plus part artifacts and list the ' +
+    'part ids in the index. The server does not auto-split.';
 export const recordArtifactCapability = {
     key: 'artifact_record',
     names: { sdk: 'artifact_record', mcp: 'ziggs_artifact_record' },
@@ -25,17 +29,23 @@ export const recordArtifactCapability = {
         sdk: 'Write an artifact. Scope is optional: pass agreementId or chatId to record it there, ' +
             'or pass no scope at all to record it as yours alone and attach it somewhere later. ' +
             'Set visibility explicitly. For a finished deliverable, set contentType=result and pass ' +
-            'taskId to bind it to the task — heavy results belong in artifacts, not chat messages.',
+            'taskId to bind it to the task — heavy results belong in artifacts, not chat messages. ' +
+            ARTIFACT_RECORD_INLINE_CAP,
         mcp: 'Write an artifact. Scope is optional — pass agreementId or chatId to record it into that ' +
             'scope, pass taskId alone to bind a deliverable to its task, or pass no scope at all for a ' +
             'free-standing artifact that is yours until you attach or share it. Never guess a scope: ' +
             'recording with none always succeeds. Set visibility explicitly. ' +
             'For a finished deliverable, set contentType=result and pass taskId to bind it to the task. ' +
-            'Finished work is the task result — set it with ziggs_task_set_result; never report finished work as a chat message (chat is conversation only).',
+            'Finished work is the task result — set it with ziggs_task_set_result; never report finished work as a chat message (chat is conversation only). ' +
+            ARTIFACT_RECORD_INLINE_CAP,
     },
     annotation: 'write',
     params: {
-        text: { type: 'string', required: true, description: 'Artifact body' },
+        text: {
+            type: 'string',
+            required: true,
+            description: 'Artifact body (max 50000 chars). Over limit: ziggs_artifact_upload_url or index+parts.',
+        },
         visibility: {
             type: 'string',
             required: true,

package/dist/http/ArtifactsClient.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Inline `POST /artifacts` body cap (matches backend
+ * `ARTIFACT_PUBLIC_TEXT_MAX_CHARS`). Over this → file rail or multi-part; the
+ * server does not auto-split (ZIG-1320).
+ */
+export declare const ARTIFACT_INLINE_TEXT_MAX_CHARS = 50000;
+/** ZIG-1320 — named escape hatch for agents that hit the inline cap. */
+export declare const ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT: string;
 export type ArtifactVisibility = 'chat' | 'agent-private';
 export interface ListArtifactsOptions {
     after?: string;

package/dist/http/ArtifactsClient.js

@@ -2,6 +2,17 @@ import { runtimeLog } from '../shared/runtimeLog.js';
 import { throwApiError } from '../shared/apiError.js';
 import { getBackendUrl } from '../utils/urlUtils.js';
 import { buildOperatorHeaders } from './operatorHeaders.js';
+/**
+ * Inline `POST /artifacts` body cap (matches backend
+ * `ARTIFACT_PUBLIC_TEXT_MAX_CHARS`). Over this → file rail or multi-part; the
+ * server does not auto-split (ZIG-1320).
+ */
+export const ARTIFACT_INLINE_TEXT_MAX_CHARS = 50_000;
+/** ZIG-1320 — named escape hatch for agents that hit the inline cap. */
+export const ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT = `text exceeds ${ARTIFACT_INLINE_TEXT_MAX_CHARS} characters. ` +
+    'For larger content use ziggs_artifact_upload_url (file rail), or split into ' +
+    'an index artifact plus part artifacts and list the part ids in the index. ' +
+    'The server does not auto-split.';
 function resolveUploadBytes(input) {
     if (input.content != null) {
         return Buffer.isBuffer(input.content)
@@ -122,12 +133,18 @@ export class ArtifactsClient {
             throw new Error('ArtifactsClient.writeStrict: text is required');
         }
         this._assertScopeXor(input);
+        const text = input.text.trim();
+        // ZIG-1320: refuse before the wire so MCP/SDK get a named escape hatch
+        // instead of a bare class-validator string.
+        if (text.length > ARTIFACT_INLINE_TEXT_MAX_CHARS) {
+            throw new Error(`ArtifactsClient.writeStrict: ${ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT}`);
+        }
         const url = `${getBackendUrl()}/artifacts`;
         const res = await fetch(url, {
             method: 'POST',
             headers: this._headers(),
             body: JSON.stringify({
-                text: input.text.trim(),
+                text,
                 contentType: input.contentType ?? 'text',
                 visibility: input.visibility ?? 'chat',
                 chatId: input.chatId,

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, artifactScopeForSession, AGREEMENT_LANE_PREFIX, } from './ArtifactsClient.js';
+export { ArtifactsClient, artifactScopeForSession, AGREEMENT_LANE_PREFIX, ARTIFACT_INLINE_TEXT_MAX_CHARS, ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT, } from './ArtifactsClient.js';
 export type { ArtifactVisibility, ListArtifactsOptions, ListArtifactsQuery, ListArtifactsResult, WriteArtifactInput, } from './ArtifactsClient.js';
 export { ContextReadClient, CONTEXT_READ_TYPES, CONTEXT_READ_VIA, VIA_KINDS, parseVia, viaHint, } from './ContextReadClient.js';
 export type { ContextReadType, ContextReadQuery, ContextReadEnvelope, ContextSnapshotResult, ViaKind, } from './ContextReadClient.js';

package/dist/http/index.js

@@ -6,7 +6,7 @@ export * from './ChatClient.js';
 export { MessagesClient } from './MessagesClient.js';
 export { ArtifactsClient, 
 // agreement lanes are not chats — callers scope artifact writes with this.
-artifactScopeForSession, AGREEMENT_LANE_PREFIX, } from './ArtifactsClient.js';
+artifactScopeForSession, AGREEMENT_LANE_PREFIX, ARTIFACT_INLINE_TEXT_MAX_CHARS, ARTIFACT_INLINE_TEXT_OVER_LIMIT_HINT, } from './ArtifactsClient.js';
 export { ContextReadClient, CONTEXT_READ_TYPES, CONTEXT_READ_VIA, VIA_KINDS, parseVia, viaHint, } 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.10.0",
+  "version": "0.10.1",
   "description": "HTTP and WebSocket client for the Ziggs backend API",
   "type": "module",
   "main": "dist/index.js",