@dingdawg/sdk 2.0.0

package/dist/durable.js

@@ -0,0 +1,223 @@
+/**
+ * @dingdawg/sdk/durable — DurableDingDawgClient
+ *
+ * Extends DingDawgClient with DDAG v1 crash-proof execution:
+ *   - invokeWithCheckpoint() — run agent step, get back a CID resume token
+ *   - resume()              — continue from a checkpoint CID (any machine)
+ *   - getSoul()             — retrieve an agent's IPFS-pinned identity
+ *
+ * What competitors don't have (in one SDK):
+ *   ✅ Log-first WAL execution  — crash = replay from log, never lose progress
+ *   ✅ IPFS content-addressed checkpoints — stateless resume on any machine
+ *   ✅ Exactly-once semantics   — idempotency keys prevent double-execution
+ *   ✅ Agent Soul persistence   — identity survives crashes and migrations
+ *   ✅ Memory class retention   — A/B/C/D with IPFS anchoring for Class A
+ */
+import { DingDawgClient, DingDawgApiError } from "./client.js";
+// ---------------------------------------------------------------------------
+// FSM state enum (mirrors isg_agent/protocol/ddag_v1.py AgentFSMState)
+// ---------------------------------------------------------------------------
+export var AgentFSMState;
+(function (AgentFSMState) {
+    AgentFSMState["Idle"] = "idle";
+    AgentFSMState["Running"] = "running";
+    AgentFSMState["ToolPending"] = "tool_pending";
+    AgentFSMState["Verifying"] = "verifying";
+    AgentFSMState["Committing"] = "committing";
+    AgentFSMState["Remediating"] = "remediating";
+    AgentFSMState["Checkpointed"] = "checkpointed";
+    AgentFSMState["Resuming"] = "resuming";
+    AgentFSMState["Done"] = "done";
+    AgentFSMState["Failed"] = "failed";
+})(AgentFSMState || (AgentFSMState = {}));
+// ---------------------------------------------------------------------------
+// SDK version
+// ---------------------------------------------------------------------------
+const SDK_USER_AGENT_DURABLE = "@dingdawg/sdk-durable/2.0.0";
+// ---------------------------------------------------------------------------
+// DurableDingDawgClient
+// ---------------------------------------------------------------------------
+/**
+ * DurableDingDawgClient — crash-proof agent execution SDK.
+ *
+ * @example Basic durable invocation
+ * ```ts
+ * import { DurableDingDawgClient } from "@dingdawg/sdk";
+ *
+ * const client = new DurableDingDawgClient({ apiKey: "dd_live_..." });
+ *
+ * const result = await client.invokeWithCheckpoint("acme-support", {
+ *   message: "Run the quarterly compliance report",
+ *   userId: "user_123",
+ * });
+ *
+ * // Save checkpoint_cid — if the process crashes, pass it to resume()
+ * console.log(result.checkpoint_cid); // "ipfs:Qm..." or "sha256:..."
+ * ```
+ *
+ * @example Resume after crash
+ * ```ts
+ * const resumed = await client.resume("acme-support", savedCheckpointCid);
+ * // Agent continues from the exact step it left off — no re-execution
+ * ```
+ */
+export class DurableDingDawgClient extends DingDawgClient {
+    _durableApiKey;
+    _durableBaseUrl;
+    constructor(opts) {
+        super(opts);
+        this._durableApiKey = opts.apiKey.trim();
+        this._durableBaseUrl = (opts.baseUrl ?? "https://api.dingdawg.com").replace(/\/$/, "");
+    }
+    // -------------------------------------------------------------------------
+    // Internal HTTP helper (mirrors DingDawgClient._request — kept private)
+    // -------------------------------------------------------------------------
+    async _durableRequest(method, path, body, extraHeaders) {
+        const url = `${this._durableBaseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            "User-Agent": SDK_USER_AGENT_DURABLE,
+            Authorization: `Bearer ${this._durableApiKey}`,
+            "X-DingDawg-SDK": "2",
+            ...extraHeaders,
+        };
+        const init = {
+            method,
+            headers,
+            ...(body !== undefined && method !== "GET"
+                ? { body: JSON.stringify(body) }
+                : {}),
+        };
+        let resp;
+        try {
+            resp = await fetch(url, init);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new DingDawgApiError({ status: 0, body: { detail: `Network error: ${msg}` } }, `Network error reaching DingDawg API: ${msg}`);
+        }
+        if (!resp.ok) {
+            let errBody = null;
+            try {
+                errBody = (await resp.json());
+            }
+            catch { /* non-JSON error */ }
+            throw new DingDawgApiError({ status: resp.status, body: errBody });
+        }
+        return (await resp.json());
+    }
+    // -------------------------------------------------------------------------
+    // Public durable API
+    // -------------------------------------------------------------------------
+    /**
+     * Invoke an agent with checkpoint support.
+     *
+     * The server journalises intent before execution and checkpoints state after.
+     * The returned `checkpoint_cid` is the durable resume token — store it.
+     * On crash, call `resume(handle, checkpoint_cid)` to continue without re-executing
+     * completed steps.
+     *
+     * @param agentHandle - Agent handle (e.g. "acme-support").
+     * @param opts        - Message options + optional resume_cid, idempotency_key, checkpoint_every.
+     * @returns DurableResponse including checkpoint_cid, step_index, verified, fsm_state.
+     */
+    async invokeWithCheckpoint(agentHandle, opts) {
+        const payload = {
+            message: opts.message,
+            user_id: opts.userId,
+            session_id: opts.sessionId,
+            metadata: opts.metadata,
+            checkpoint_every: opts.checkpoint_every ?? 1,
+        };
+        if (opts.resume_cid !== undefined)
+            payload["resume_cid"] = opts.resume_cid;
+        if (opts.idempotency_key !== undefined)
+            payload["idempotency_key"] = opts.idempotency_key;
+        const extraHeaders = {};
+        if (opts.idempotency_key !== undefined) {
+            extraHeaders["Idempotency-Key"] = opts.idempotency_key;
+        }
+        const raw = await this._durableRequest("POST", `/api/v2/agents/${encodeURIComponent(agentHandle)}/durable/invoke`, payload, extraHeaders);
+        return _normalizeDurableResponse(raw);
+    }
+    /**
+     * Resume execution from a checkpoint CID.
+     *
+     * Stateless — can be called from any process, any machine.
+     * The server restores state from the CID, skips already-completed steps,
+     * and continues forward.
+     *
+     * @param agentHandle    - Agent handle.
+     * @param checkpointCid  - The CID returned by a previous invokeWithCheckpoint call.
+     * @returns DurableResponse with the next checkpoint_cid.
+     */
+    async resume(agentHandle, checkpointCid) {
+        const raw = await this._durableRequest("POST", `/api/v2/agents/${encodeURIComponent(agentHandle)}/durable/resume`, { checkpoint_cid: checkpointCid });
+        return _normalizeDurableResponse(raw);
+    }
+    /**
+     * Retrieve an agent's soul — IPFS-pinned identity that survives all restarts.
+     *
+     * @param agentHandle - Agent handle.
+     * @returns AgentSoul with soul_cid, mission, and learned_prefs.
+     */
+    async getSoul(agentHandle) {
+        const raw = await this._durableRequest("GET", `/api/v2/agents/${encodeURIComponent(agentHandle)}/soul`);
+        return {
+            soul_id: String(raw["soul_id"] ?? ""),
+            agent_id: String(raw["agent_id"] ?? ""),
+            soul_cid: String(raw["soul_cid"] ?? ""),
+            mission: String(raw["mission"] ?? ""),
+            learned_prefs: raw["learned_prefs"] ?? {},
+            created_at: String(raw["created_at"] ?? ""),
+            updated_at: String(raw["updated_at"] ?? ""),
+        };
+    }
+    /**
+     * Get the latest checkpoint for a session.
+     *
+     * Useful for polling long-running agent tasks.
+     *
+     * @param agentHandle - Agent handle.
+     * @param sessionId   - Session ID.
+     * @returns CheckpointState or null if no checkpoint exists yet.
+     */
+    async getCheckpoint(agentHandle, sessionId) {
+        try {
+            const raw = await this._durableRequest("GET", `/api/v2/agents/${encodeURIComponent(agentHandle)}/durable/checkpoint/${encodeURIComponent(sessionId)}`);
+            return _normalizeCheckpointState(raw);
+        }
+        catch (err) {
+            if (err instanceof DingDawgApiError && err.status === 404)
+                return null;
+            throw err;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Normalizers
+// ---------------------------------------------------------------------------
+function _normalizeDurableResponse(raw) {
+    return {
+        reply: String(raw["reply"] ?? raw["response"] ?? ""),
+        sessionId: String(raw["session_id"] ?? raw["sessionId"] ?? ""),
+        timestamp: String(raw["timestamp"] ?? new Date().toISOString()),
+        queued: raw["queued"] === true,
+        ...(raw["model"] !== undefined ? { model: String(raw["model"]) } : {}),
+        checkpoint_cid: String(raw["checkpoint_cid"] ?? ""),
+        step_index: raw["step_index"] ?? 0,
+        verified: raw["verified"] === true,
+        fsm_state: raw["fsm_state"] ?? AgentFSMState.Done,
+        ...(raw["proof_cid"] !== undefined ? { proof_cid: String(raw["proof_cid"]) } : {}),
+    };
+}
+function _normalizeCheckpointState(raw) {
+    return {
+        session_id: String(raw["session_id"] ?? ""),
+        step_index: raw["step_index"] ?? 0,
+        state_cid: String(raw["state_cid"] ?? ""),
+        fsm_state: raw["fsm_state"] ?? AgentFSMState.Idle,
+        created_at: String(raw["created_at"] ?? ""),
+    };
+}
+//# sourceMappingURL=durable.js.map

package/dist/durable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable.js","sourceRoot":"","sources":["../src/durable.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @dingdawg/sdk — Public API
+ *
+ * Re-exports everything a partner integration needs:
+ * - DingDawgClient (main class)
+ * - DurableDingDawgClient (crash-proof execution — DDAG v1)
+ * - DingDawgApiError (typed error)
+ * - All TypeScript interfaces and types
+ */
+export { DingDawgClient, DingDawgApiError } from "./client.js";
+export type { DingDawgClientOptions, AgentType, AgentStatus, AgentBranding, CreateAgentOptions, AgentRecord, SendMessageOptions, TriggerResponse, BillingLineItem, MonthlyBillingSummary, BillingSummary, PaginatedList, ApiErrorBody, DingDawgApiErrorDetails, } from "./types.js";
+export { DurableDingDawgClient, AgentFSMState } from "./durable.js";
+export type { CheckpointState, AgentSoul, DurableSession, DurableResponse, } from "./durable.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,YAAY,EAEV,qBAAqB,EAErB,SAAS,EACT,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EAEX,kBAAkB,EAClB,eAAe,EAEf,eAAe,EACf,qBAAqB,EACrB,cAAc,EAEd,aAAa,EACb,YAAY,EACZ,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEpE,YAAY,EACV,eAAe,EACf,SAAS,EACT,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * @dingdawg/sdk — Public API
+ *
+ * Re-exports everything a partner integration needs:
+ * - DingDawgClient (main class)
+ * - DurableDingDawgClient (crash-proof execution — DDAG v1)
+ * - DingDawgApiError (typed error)
+ * - All TypeScript interfaces and types
+ */
+export { DingDawgClient, DingDawgApiError } from "./client.js";
+// DDAG v1 — Durable execution SDK
+export { DurableDingDawgClient, AgentFSMState } from "./durable.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAwB/D,kCAAkC;AAClC,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @dingdawg/sdk — TypeScript types for all request and response shapes.
+ *
+ * All interfaces are exported so partner integrations can type their own code.
+ * Zero runtime imports — types are erased at compile time.
+ */
+/** Options passed to the DingDawgClient constructor. */
+export interface DingDawgClientOptions {
+    /** API key issued via the DingDawg dashboard or partner program. */
+    apiKey: string;
+    /** Base URL of the DingDawg API. Defaults to https://api.dingdawg.com */
+    baseUrl?: string;
+}
+/** Structured API error returned by the DingDawg backend. */
+export interface ApiErrorBody {
+    detail?: string;
+    message?: string;
+    code?: string;
+    [key: string]: unknown;
+}
+/** Error thrown when an API call fails with a non-2xx response. */
+export interface DingDawgApiErrorDetails {
+    /** HTTP status code (e.g. 401, 422, 500). */
+    status: number;
+    /** Parsed error body from the API, if available. */
+    body: ApiErrorBody | null;
+}
+/** Agent type identifier. */
+export type AgentType = "personal" | "business" | "b2b" | "a2a" | "compliance" | "enterprise" | "health" | "gaming";
+/** Agent status values. */
+export type AgentStatus = "active" | "inactive" | "suspended";
+/** Branding configuration for an agent. */
+export interface AgentBranding {
+    /** Hex color string (e.g. "#7C3AED"). */
+    primaryColor?: string;
+    /** Public URL to an avatar image. */
+    avatarUrl?: string;
+}
+/** Options for creating a new agent. */
+export interface CreateAgentOptions {
+    /** Display name of the agent. */
+    name: string;
+    /** Unique handle (without @). Must be 3-32 alphanumeric + underscores. */
+    handle: string;
+    /** Agent type selector. Defaults to "business". */
+    agentType?: AgentType;
+    /** Sector / industry label (e.g. "restaurant", "gaming", "legal"). */
+    industry?: string;
+    /** System prompt / constitution text. */
+    systemPrompt?: string;
+    /** Template ID to initialise the agent from. */
+    templateId?: string;
+    /** Branding overrides. */
+    branding?: AgentBranding;
+}
+/** A deployed agent record returned by the API. */
+export interface AgentRecord {
+    id: string;
+    handle: string;
+    name: string;
+    agentType: AgentType;
+    industry: string | null;
+    status: AgentStatus;
+    createdAt: string;
+    updatedAt: string;
+    /** Parsed branding config. Present on GET /agents/:id, may be absent in list. */
+    branding?: AgentBranding;
+}
+/** Options for sending a message to an agent via the trigger endpoint. */
+export interface SendMessageOptions {
+    /** The message text to deliver. */
+    message: string;
+    /** User / customer identifier (for conversation continuity). */
+    userId?: string;
+    /** Session identifier to continue an existing conversation. */
+    sessionId?: string;
+    /** Arbitrary metadata forwarded to the agent runtime. */
+    metadata?: Record<string, unknown>;
+}
+/** Response returned after triggering an agent. */
+export interface TriggerResponse {
+    /** The agent's reply text. */
+    reply: string;
+    /** Session ID (reuse to continue the conversation). */
+    sessionId: string;
+    /** ISO-8601 timestamp of the response. */
+    timestamp: string;
+    /** Model / provider used to generate the reply. */
+    model?: string;
+    /** True when the agent queued the message for async processing. */
+    queued?: boolean;
+}
+/** Line item in a billing period. */
+export interface BillingLineItem {
+    /** Action / skill name (e.g. "crm_lookup", "email_send"). */
+    action: string;
+    /** Number of times this action was executed. */
+    count: number;
+    /** Cost in USD cents. */
+    costCents: number;
+}
+/** Billing summary for a single month. */
+export interface MonthlyBillingSummary {
+    /** ISO-8601 month string (e.g. "2026-03"). */
+    month: string;
+    /** Total actions executed. */
+    totalActions: number;
+    /** Total charges in USD cents. */
+    totalCents: number;
+    /** Number of free-tier actions remaining (50 free/month). */
+    freeActionsRemaining: number;
+    /** Breakdown by action type. */
+    lineItems: BillingLineItem[];
+}
+/** Aggregate billing summary across all time. */
+export interface BillingSummary {
+    /** Total lifetime actions. */
+    totalActions: number;
+    /** Total lifetime spend in USD cents. */
+    totalCents: number;
+    /** Current month billing. */
+    currentMonth: MonthlyBillingSummary;
+    /** Stripe customer ID if billing is set up. */
+    stripeCustomerId?: string;
+}
+/** Generic paginated list wrapper. */
+export interface PaginatedList<T> {
+    items: T[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @dingdawg/sdk — TypeScript types for all request and response shapes.
+ *
+ * All interfaces are exported so partner integrations can type their own code.
+ * Zero runtime imports — types are erased at compile time.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@dingdawg/sdk",
+  "version": "2.0.0",
+  "description": "DingDawg Agent SDK \u2014 durable AI agents with crash-proof exactly-once execution + IPFS checkpoints",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest --testPathPattern='src/__tests__'",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "sdk",
+    "dingdawg",
+    "mcp",
+    "a2a",
+    "llm",
+    "b2b2c"
+  ],
+  "license": "MIT",
+  "author": "Innovative Systems Global LLC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dingdawg/sdk"
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.19.37",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    },
+    "transform": {
+      "^.+\\.tsx?$": [
+        "ts-jest",
+        {
+          "useESM": true
+        }
+      ]
+    }
+  }
+}