@ziggy-ai/client-sdk 0.1.0 → 0.1.2

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,qBAAa,WAAW;IACtB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IAEpC,OAAO,CAAC,UAAU,CAAa;gBAEnB,MAAM,EAAE,iBAAiB;IAarC;;;OAGG;IACG,OAAO,CAAC,OAAO,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;KACrD;IAcD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAKlC;AAGD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACd,UAAU,EACV,MAAM,EACN,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,EACL,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,5 +1,8 @@
-// src/types.ts
+// src/types.js
 var ZiggyError = class extends Error {
+  status;
+  code;
+  details;
   constructor(message, status, code, details) {
     super(message);
     this.status = status;
@@ -9,6 +12,7 @@ var ZiggyError = class extends Error {
   }
 };
 var ZiggyConnectionError = class extends ZiggyError {
+  retryable;
   constructor(message, retryable = true) {
     super(message, 0, "CONNECTION_ERROR");
     this.retryable = retryable;
@@ -16,7 +20,7 @@ var ZiggyConnectionError = class extends ZiggyError {
   }
 };
 
-// src/auth.ts
+// src/auth.js
 function buildHeaders(config, extra) {
   return {
     "Content-Type": "application/json",
@@ -25,7 +29,7 @@ function buildHeaders(config, extra) {
   };
 }
 
-// src/connection.ts
+// src/connection.js
 var Connection = class {
   config;
   constructor(config) {
@@ -59,14 +63,12 @@ var Connection = class {
       }
       return await response.json();
     } catch (error) {
-      if (error instanceof ZiggyError) throw error;
+      if (error instanceof ZiggyError)
+        throw error;
       if (error instanceof DOMException && error.name === "AbortError") {
         throw new ZiggyConnectionError("Request timed out", true);
       }
-      throw new ZiggyConnectionError(
-        error instanceof Error ? error.message : "Connection failed",
-        true
-      );
+      throw new ZiggyConnectionError(error instanceof Error ? error.message : "Connection failed", true);
     } finally {
       clearTimeout(timer);
     }
@@ -95,11 +97,9 @@ var Connection = class {
       }
       return response;
     } catch (error) {
-      if (error instanceof ZiggyError) throw error;
-      throw new ZiggyConnectionError(
-        error instanceof Error ? error.message : "Connection failed",
-        true
-      );
+      if (error instanceof ZiggyError)
+        throw error;
+      throw new ZiggyConnectionError(error instanceof Error ? error.message : "Connection failed", true);
     }
   }
 };
@@ -261,6 +261,39 @@ var ChatClient = class {
       yield event;
     }
   }
+  /**
+   * Execute a support action by ID (non-streaming).
+   * Actions from trigger buttons and quick actions go through this method.
+   */
+  async action(request) {
+    const sessionId = this.sessionManager.sessionId;
+    if (!sessionId) throw new Error("No active session");
+    if (!this.userId) throw new Error("No user ID set");
+    return this.connection.request("POST", "/chat/action", {
+      sessionId,
+      userId: this.userId,
+      ...request
+    });
+  }
+  /**
+   * Execute a support action by ID (streaming).
+   * Returns an async iterable of structured stream events.
+   */
+  async *actionStream(request) {
+    const sessionId = this.sessionManager.sessionId;
+    if (!sessionId) throw new Error("No active session");
+    if (!this.userId) throw new Error("No user ID set");
+    const response = await this.connection.streamRequest("POST", "/chat/action/stream", {
+      sessionId,
+      userId: this.userId,
+      ...request
+    });
+    const tracker = new SequenceTracker();
+    for await (const event of parseNdjsonStream(response)) {
+      tracker.update(event);
+      yield event;
+    }
+  }
   /**
    * Resume an interrupted stream from a given sequence number.
    */
@@ -545,7 +578,7 @@ var AnalyticsClient = class {
   }
 };
 
-// src/app.ts
+// src/app.js
 var AppClient = class {
   connection;
   constructor(connection) {
@@ -624,7 +657,7 @@ var AppClient = class {
   }
 };
 
-// src/callback-handler.ts
+// src/callback-handler.js
 var CallbackHandler = class {
   handlers = /* @__PURE__ */ new Map();
   /**

package/dist/quests.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Quest tracking module.
+ */
+import type { Connection } from './connection.js';
+import type { Quest, StreamEvent, CreateQuestRequest, UpdateQuestRequest, UpdateQuestStepRequest } from './types.js';
+export declare class QuestClient {
+    private connection;
+    constructor(connection: Connection);
+    /**
+     * Create a new quest.
+     */
+    create(request: CreateQuestRequest): Promise<Quest>;
+    /**
+     * Get quest status.
+     */
+    get(questId: string): Promise<Quest>;
+    /**
+     * Update quest status, context, or result.
+     */
+    update(questId: string, updates: UpdateQuestRequest): Promise<Quest>;
+    /**
+     * Update a specific quest step.
+     */
+    updateStep(questId: string, stepId: string, updates: UpdateQuestStepRequest): Promise<Quest>;
+    /**
+     * Cancel a quest.
+     */
+    cancel(questId: string): Promise<Quest>;
+    /**
+     * List quests for a session.
+     */
+    list(sessionId: string): Promise<Quest[]>;
+    /**
+     * Stream quest updates with optional resumption.
+     */
+    stream(questId: string, afterSeq?: number): AsyncGenerator<StreamEvent, void, undefined>;
+}
+//# sourceMappingURL=quests.d.ts.map

package/dist/quests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quests.d.ts","sourceRoot":"","sources":["../src/quests.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,KAAK,EACL,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAGpB,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAa;gBAEnB,UAAU,EAAE,UAAU;IAIlC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IASzD;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAK1C;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAS1E;;OAEG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,KAAK,CAAC;IASjB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI7C;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ/C;;OAEG;IACI,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;CAWhD"}

package/dist/session.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Session management module.
+ */
+import type { Connection } from './connection.js';
+import type { ZiggyClientConfig, CreateSessionRequest, SessionResponse, ContextPushRequest, ContextPushResponse } from './types.js';
+export declare class SessionManager {
+    private connection;
+    private appId;
+    private _sessionId;
+    private _conversationId;
+    constructor(connection: Connection, config: ZiggyClientConfig);
+    get sessionId(): string | null;
+    get conversationId(): string | null;
+    /**
+     * Create or resume a session.
+     * Replaces 4 separate calls (brand + context + triggers + actions).
+     */
+    create(request: CreateSessionRequest): Promise<SessionResponse>;
+    /**
+     * Push context update (delta merge) with piggybacked trigger evaluation.
+     */
+    pushContext(userId: string, context: Record<string, unknown>, events?: ContextPushRequest['events']): Promise<ContextPushResponse>;
+    /**
+     * End the current session.
+     */
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,eAAe,CAAuB;gBAElC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB;IAK7D,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAarE;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAY/B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B"}

package/dist/stream-parser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * NDJSON Stream Parser
+ *
+ * Parses newline-delimited JSON streams with sequence tracking
+ * and reconnection support.
+ */
+import type { StreamEvent } from './types.js';
+/**
+ * Parse an ndjson Response body into an async iterable of StreamEvents.
+ * Tracks the last seen sequence number for reconnection.
+ */
+export declare function parseNdjsonStream(response: Response): AsyncGenerator<StreamEvent, void, undefined>;
+/**
+ * Track last seen sequence number from a stream.
+ */
+export declare class SequenceTracker {
+    private _lastSeq;
+    private _streamId;
+    get lastSeq(): number;
+    get streamId(): string | null;
+    update(event: StreamEvent): void;
+    reset(): void;
+}
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/stream-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.d.ts","sourceRoot":"","sources":["../src/stream-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAuB,iBAAiB,CACtC,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC,CA8C9C;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,SAAS,CAAuB;IAExC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAShC,KAAK,IAAI,IAAI;CAId"}

package/dist/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool invocation module.
+ */
+import type { Connection } from './connection.js';
+import type { SessionManager } from './session.js';
+import type { ToolInvokeResponse, StreamEvent } from './types.js';
+export declare class ToolClient {
+    private connection;
+    private sessionManager;
+    private userId;
+    constructor(connection: Connection, sessionManager: SessionManager);
+    setUserId(userId: string): void;
+    /**
+     * Invoke a tool (non-streaming).
+     */
+    invoke(toolId: string, input?: Record<string, unknown>): Promise<ToolInvokeResponse>;
+    /**
+     * Invoke a tool with streaming (for long-running tools).
+     */
+    invokeStream(toolId: string, input?: Record<string, unknown>): AsyncGenerator<StreamEvent, void, undefined>;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGlE,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc;IAKlE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAa1F;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;CAgBnH"}