@darqlabs/curator-sdk 0.1.6 → 0.3.0

package/dist/esm/errors.js

@@ -9,9 +9,45 @@
  * backstop.
  */
 export class CuratorError extends Error {
+    /**
+     * What an END USER may be shown.
+     *
+     * `message` is for developers — it can name the request, the status, and the
+     * server's own wording. That is the wrong text to put in a chat bubble, and
+     * shipping it there is not a hypothetical: a 500 rendered as
+     * `HTTP 500 from https://api.../agents/<slug>/conversations: …`, exposing the
+     * deployment's URL to whoever was chatting, and an end-user token failure
+     * rendered as "End-user JWT could not be verified", which tells the person
+     * nothing they can act on and leaks the auth mechanism.
+     *
+     * Every subclass sets this to something safe and actionable. `renderError` in
+     * the React bindings prefers it and never falls back to `message`, so a new
+     * error type is safe-by-default rather than leaky-by-default.
+     */
+    userMessage;
+    /** HTTP status, when this came from a response. */
+    status;
+    /** Server error code (`error.code`), when present. */
+    code;
+    /**
+     * Correlation id from `x-request-id` / `correlationId`. The one detail worth
+     * showing a user on an unexpected failure — it is what support can trace,
+     * and it says nothing about the system's shape.
+     */
+    requestId;
+    /**
+     * Request URL, as a PROPERTY rather than part of `message`. Available for
+     * logs and bug reports without riding along into anything user-visible.
+     */
+    url;
     constructor(message, options) {
         super(message);
         this.name = "CuratorError";
+        this.userMessage = options?.userMessage ?? DEFAULT_USER_MESSAGE;
+        this.status = options?.status ?? null;
+        this.code = options?.code ?? null;
+        this.requestId = options?.requestId ?? null;
+        this.url = options?.url ?? null;
         // Preserve the underlying error if the runtime supports it.
         if (options?.cause !== undefined) {
             ;
@@ -19,32 +55,65 @@ export class CuratorError extends Error {
         }
     }
 }
+/** Last-resort user-facing text. Deliberately says nothing about the system. */
+export const DEFAULT_USER_MESSAGE = "Something went wrong. Please try again.";
+/** Appends a correlation id when there is one, so support has a handle. */
+export function withRequestId(text, requestId) {
+    return requestId ? `${text} (reference: ${requestId})` : text;
+}
 /** HTTP 401 from the API — your API key is missing, invalid, or revoked. */
 export class CuratorAuthError extends CuratorError {
-    constructor(message = "Invalid or revoked API key") {
-        super(message);
+    constructor(message = "Invalid or revoked API key", ctx = {}) {
+        // The API key is the INTEGRATOR's credential. An end user can do nothing
+        // about it and should not be told which credential failed.
+        super(message, { ...ctx, userMessage: "This chat isn't available right now. Please try again later." });
         this.name = "CuratorAuthError";
     }
 }
+/**
+ * HTTP 401 specifically because the END-USER token was missing, expired, or
+ * unverifiable — distinct from `CuratorAuthError`, which is about the
+ * integrator's API key.
+ *
+ * Separate because the remediation is completely different: an API-key failure
+ * needs a developer, whereas this one is usually a stale session the user fixes
+ * by signing in again. Collapsing them produced "Authentication failed. Check
+ * your API key." in response to an expired user token, which sends the reader
+ * after the wrong thing entirely.
+ */
+export class CuratorEndUserAuthError extends CuratorError {
+    constructor(message = "End-user token could not be verified", ctx = {}) {
+        super(message, {
+            ...ctx,
+            userMessage: "Your session has expired. Please sign in again to continue.",
+        });
+        this.name = "CuratorEndUserAuthError";
+    }
+}
 /** HTTP 403 from the API — your API key doesn't have permission for this action. */
 export class CuratorForbiddenError extends CuratorError {
-    constructor(message = "Permission denied") {
-        super(message);
+    constructor(message = "Permission denied", ctx = {}) {
+        super(message, { ...ctx, userMessage: "You don't have access to this." });
         this.name = "CuratorForbiddenError";
     }
 }
 /** HTTP 404 from the API — the deployment slug or conversation id wasn't found. */
 export class CuratorNotFoundError extends CuratorError {
-    constructor(message = "Resource not found") {
-        super(message);
+    constructor(message = "Resource not found", ctx = {}) {
+        // Says nothing about WHICH resource: on a 404 the slug is often the thing
+        // that is wrong, and echoing it back tells a prober they guessed close.
+        super(message, { ...ctx, userMessage: "This chat isn't available." });
         this.name = "CuratorNotFoundError";
     }
 }
 /** HTTP 410 from the API — the deployment was retired. */
 export class CuratorDeploymentRetiredError extends CuratorError {
     retiredAt;
-    constructor(message, retiredAt) {
-        super(message);
+    constructor(message, retiredAt, ctx = {}) {
+        super(message, {
+            ...ctx,
+            userMessage: "This assistant is no longer available.",
+        });
         this.name = "CuratorDeploymentRetiredError";
         this.retiredAt = retiredAt;
     }
@@ -52,12 +121,31 @@ export class CuratorDeploymentRetiredError extends CuratorError {
 /** HTTP 429 from the API — back off. */
 export class CuratorRateLimitError extends CuratorError {
     retryAfterSeconds;
-    constructor(message = "Rate limit exceeded", retryAfterSeconds = null) {
-        super(message);
+    constructor(message = "Rate limit exceeded", retryAfterSeconds = null, ctx = {}) {
+        super(message, {
+            ...ctx,
+            userMessage: retryAfterSeconds
+                ? `Too many messages. Please wait ${retryAfterSeconds} seconds and try again.`
+                : "Too many messages. Please wait a moment and try again.",
+        });
         this.name = "CuratorRateLimitError";
         this.retryAfterSeconds = retryAfterSeconds;
     }
 }
+/**
+ * HTTP 5xx. The server already returns a generic body plus a `correlationId`
+ * for unexpected failures, so the useful thing to surface is that id — not the
+ * status line and URL the SDK used to build into `message`.
+ */
+export class CuratorServerError extends CuratorError {
+    constructor(message, ctx = {}) {
+        super(message, {
+            ...ctx,
+            userMessage: withRequestId("Something went wrong on our end. Please try again.", ctx.requestId ?? null),
+        });
+        this.name = "CuratorServerError";
+    }
+}
 /**
  * Run paused waiting for human approval. Approval resolution is not
  * exposed to API consumers — pauses are routed through the dashboard
@@ -71,7 +159,10 @@ export class CuratorApprovalRequiredError extends CuratorError {
     runId;
     constructor(args) {
         super(`Run paused for approval — the '${args.approval.tool_name}' tool needs an administrator to review it. ` +
-            "Contact your administrator to resolve this in the Curator dashboard.");
+            "Contact your administrator to resolve this in the Curator dashboard.", {
+            userMessage: `That action needs administrator approval. Someone has been asked to review the ` +
+                `"${args.approval.tool_name}" request.`,
+        });
         this.name = "CuratorApprovalRequiredError";
         this.approval = args.approval;
         this.conversationId = args.conversationId;
@@ -92,13 +183,62 @@ export class CuratorAuthorizationRequiredError extends CuratorError {
         super(`Run paused for authorization — connect ${args.authorization.provider} to continue. ` +
             (args.authorization.connect_url
                 ? `Connect at ${args.authorization.connect_url}, then resume the conversation.`
-                : "Connect the provider, then resume the conversation."));
+                : "Connect the provider, then resume the conversation."), {
+            // `reason` is authored for the end user by the integration; prefer it.
+            userMessage: args.authorization.reason ||
+                `Connect your ${args.authorization.provider} account to continue.`,
+        });
         this.name = "CuratorAuthorizationRequiredError";
         this.authorization = args.authorization;
         this.conversationId = args.conversationId;
         this.runId = args.runId;
     }
 }
+const DELEGATION_CODES = [
+    "DELEGATED_IDENTITY_EXPIRED",
+    "DELEGATED_IDENTITY_REVOKED",
+    "DELEGATED_TOKEN_EXCHANGE_FAILED",
+    "DOWNSTREAM_AUTH_REJECTED",
+    "DELEGATED_AUTH_NOT_CONFIGURED",
+];
+/** Recover the delegated-failure code from a server message prefix. */
+export function parseDelegationFailureCode(message) {
+    if (!message)
+        return null;
+    for (const code of DELEGATION_CODES) {
+        if (message.startsWith(`${code}:`))
+            return code;
+    }
+    return null;
+}
+/**
+ * End-user text per delegated-failure code. The split that matters is WHO can
+ * fix it: expiry is the user's to resolve by re-authenticating, revocation and
+ * scope gaps need an administrator, and the exchange/config failures are ours
+ * and must not be phrased as the user's fault.
+ */
+function delegationUserMessage(code) {
+    switch (code) {
+        case "DELEGATED_IDENTITY_EXPIRED":
+            // The common one: a run paused past the assertion's lifetime. Retrying
+            // the same request is futile, so the text must ask for a NEW session
+            // rather than inviting another attempt.
+            return "Your session expired before that could finish. Please sign in again and retry.";
+        case "DELEGATED_IDENTITY_REVOKED":
+            // Server-side this pages someone — it means a context was crossed or
+            // probed. Never hint at the mechanism; the user just lacks authority.
+            return "You don't have permission to complete that action. Please contact your administrator.";
+        case "DOWNSTREAM_AUTH_REJECTED":
+            // Exchange worked; the resource server said no. A scope/permission gap on
+            // the customer's side, so an administrator is the right destination.
+            return "Your account doesn't have access to what that action needed. Please contact your administrator.";
+        case "DELEGATED_TOKEN_EXCHANGE_FAILED":
+        case "DELEGATED_AUTH_NOT_CONFIGURED":
+            // Ours to fix. Do not tell the user to sign in — it will not help, and it
+            // sends them chasing a problem they cannot see.
+            return "That action isn't available right now. Please try again later.";
+    }
+}
 /**
  * The agent run reached a terminal error state (LLM quota, auth, 5xx
  * exhausted retries, etc.). `failureClass` and `isPermanent` mirror the
@@ -110,9 +250,29 @@ export class CuratorAgentError extends CuratorError {
     conversationId;
     runId;
     stepId;
+    /**
+     * Set when the run failed on delegated identity. Distinct from
+     * `failureClass`, which has no delegated variant — see
+     * {@link DelegationFailureCode}.
+     */
+    delegationCode;
     constructor(args) {
-        super(args.message);
+        const delegationCode = parseDelegationFailureCode(args.message);
+        super(args.message, {
+            // NOT `args.message`: the run's failure text is written for an operator
+            // and can name providers, quotas, or step ids. A delegated failure gets
+            // its own text because the server already told us who can fix it —
+            // throwing that away and falling back to `isPermanent` is how an expired
+            // session became "couldn't complete that request", which is true and
+            // useless when "sign in again" was the answer.
+            userMessage: delegationCode
+                ? delegationUserMessage(delegationCode)
+                : args.isPermanent
+                    ? "The assistant couldn't complete that request. Please try rephrasing, or contact support."
+                    : "The assistant hit a temporary problem. Please try again.",
+        });
         this.name = "CuratorAgentError";
+        this.delegationCode = delegationCode;
         this.failureClass = args.failureClass;
         this.isPermanent = args.isPermanent;
         this.conversationId = args.conversationId;
@@ -130,7 +290,9 @@ export class CuratorTimeoutError extends CuratorError {
     runId;
     continueWaiting;
     constructor(args) {
-        super("Timed out waiting for the agent to reply — the run is still in progress.");
+        super("Timed out waiting for the agent to reply — the run is still in progress.", {
+            userMessage: "This is taking longer than usual. It may still finish — check back in a moment.",
+        });
         this.name = "CuratorTimeoutError";
         this.conversationId = args.conversationId;
         this.runId = args.runId;

package/dist/esm/errors.js.map

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

package/dist/esm/graph.d.ts

@@ -0,0 +1,307 @@
+/**
+ * Flow-graph authoring + run surface for the Curator SDK.
+ *
+ *   import { Curator, reducers, agentNode, toolNode, transformNode, edge, branch, when } from "@darqlabs/curator-sdk"
+ *
+ *   const draft = curator.defineGraph({
+ *     name: "copy-loop",
+ *     state: { messages: reducers.append(), draft: reducers.lastValue(), revisions: reducers.counter() },
+ *     nodes: {
+ *       write:  agentNode("copywriter"),
+ *       review: toolNode("api.grammar.check"),
+ *       score:  transformNode({ transformId: "tf_quality", version: 1 }),
+ *     },
+ *     entry: "write",
+ *     edges: [
+ *       edge("write", "review"),
+ *       edge("review", "score"),
+ *       branch("score", when("draft_ok", "==", true).then("END").else("write")),
+ *     ],
+ *     recursionLimit: 12,
+ *   })
+ *
+ *   const graph = await curator.graphs.create(draft)   // POST /api/graphs
+ *   await graph.deploy({ expectedDraftRevision: 1 })   // versioned snapshot
+ *
+ *   // run + stream node/state events
+ *   for await (const ev of graph.stream({ messages: [] })) {
+ *     if (ev.type === "node.completed") console.log("done:", ev.node)
+ *     if (ev.type === "done") console.log("final:", ev.state)
+ *   }
+ *
+ * These graph types are SDK-owned (the SDK is published and cannot depend on the
+ * private @darq/shared-types); they mirror the backend spec shape exactly so the
+ * assembled JSON validates + compiles server-side.
+ */
+import type { HttpClient } from "./http.js";
+import type { Environment } from "./types.js";
+export interface TransformRef {
+    transformId: string;
+    version: number;
+    autoUpdate?: boolean;
+}
+export type ReducerKind = "append" | "lastValue" | "merge" | "counter" | "custom";
+export interface ChannelDescriptor {
+    reducer: ReducerKind;
+    reducerRef?: TransformRef;
+    initialValue?: unknown;
+    description?: string;
+}
+export type JoinPolicy = "all" | "any";
+export interface NodeCommon {
+    inputChannels?: string[];
+    inputTransform?: TransformRef;
+    outputTransform?: TransformRef;
+    join?: JoinPolicy;
+    timeout?: number;
+    maxVisits?: number;
+    label?: string;
+}
+export interface AgentGraphNode extends NodeCommon {
+    type: "agent";
+    agentId: string;
+    instructions?: string;
+}
+export interface ToolGraphNode extends NodeCommon {
+    type: "tool";
+    action: string;
+    parameters?: Record<string, unknown>;
+}
+export interface TransformGraphNode extends NodeCommon {
+    type: "transform";
+    transform: TransformRef;
+}
+/**
+ * Fans its inline `body` out over the elements of the `over` channel (an array),
+ * appending each body output into `collect`. Body params/instructions can reference
+ * the current element via `{{item}}` / `{{item.field}}` / `{{index}}`. Body may be
+ * an agent/tool/transform node — not another forEach (no nesting).
+ */
+export interface ForEachGraphNode extends NodeCommon {
+    type: "forEach";
+    over: string;
+    body: GraphNode;
+    collect?: string;
+    itemAs?: string;
+}
+export type GraphNode = AgentGraphNode | ToolGraphNode | TransformGraphNode | ForEachGraphNode;
+export type BranchOp = "==" | "!=" | ">" | ">=" | "<" | "<=" | "in" | "not_in" | "exists" | "truthy" | "falsy";
+export interface BranchPredicate {
+    channel: string;
+    op: BranchOp;
+    value?: unknown;
+}
+export type Branch = {
+    kind: "predicate";
+    predicate: BranchPredicate;
+    then: string;
+    else: string;
+} | {
+    kind: "router";
+    transform: TransformRef;
+    targets: string[];
+};
+export interface StaticEdge {
+    kind: "static";
+    from: string;
+    to: string;
+}
+export interface ConditionalEdge {
+    kind: "conditional";
+    from: string;
+    branch: Branch;
+}
+export type GraphEdge = StaticEdge | ConditionalEdge;
+export interface GraphSpec {
+    state: Record<string, ChannelDescriptor>;
+    nodes: Record<string, GraphNode>;
+    entry: string;
+    edges: GraphEdge[];
+    recursionLimit?: number;
+    toolFailureMode?: "strict" | "best_effort";
+}
+/** The `END` sentinel target. */
+export declare const GRAPH_END: "END";
+export type GraphRunStatus = "running" | "paused" | "succeeded" | "failed" | "cancelled";
+export type GraphNodeRunStatus = "pending" | "ready" | "running" | "succeeded" | "failed" | "skipped";
+export interface GraphNodeRunView {
+    key: string;
+    type: GraphNode["type"];
+    status: GraphNodeRunStatus;
+    visits: number;
+    childRunId?: string;
+}
+export interface GraphRunView {
+    runId: string;
+    graphId: string;
+    versionId: string;
+    status: GraphRunStatus;
+    spec: GraphSpec;
+    nodes: GraphNodeRunView[];
+    hops: number;
+    recursionLimit: number;
+    state: Record<string, unknown>;
+    errorCode?: string;
+    errorMessage?: string;
+}
+/** Streamed node/state lifecycle, derived from run-view snapshots. */
+export type GraphRunEvent = {
+    type: "run.started";
+    runId: string;
+} | {
+    type: "node.started";
+    node: string;
+    visit: number;
+} | {
+    type: "node.completed";
+    node: string;
+} | {
+    type: "node.failed";
+    node: string;
+} | {
+    type: "state.delta";
+    channels: Record<string, unknown>;
+} | {
+    type: "done";
+    status: GraphRunStatus;
+    state: Record<string, unknown>;
+} | {
+    type: "error";
+    message: string;
+};
+export declare const reducers: {
+    append: () => ChannelDescriptor;
+    lastValue: () => ChannelDescriptor;
+    merge: () => ChannelDescriptor;
+    counter: () => ChannelDescriptor;
+    /** A custom fold `(prev, update) => next`, run as a sandboxed transform. */
+    custom: (transform: TransformRef) => ChannelDescriptor;
+};
+export declare function agentNode(agentId: string, opts?: Omit<AgentGraphNode, "type" | "agentId">): AgentGraphNode;
+export declare function toolNode(action: string, opts?: Omit<ToolGraphNode, "type" | "action">): ToolGraphNode;
+export declare function transformNode(transform: TransformRef, opts?: Omit<TransformGraphNode, "type" | "transform">): TransformGraphNode;
+/**
+ * A `forEach` (map) node: run `body` per element of the `over` channel, appending
+ * each output into `collect`. Body params can reference the element via
+ * `{{item}}` / `{{item.field}}` / `{{index}}`.
+ */
+export declare function forEachNode(over: string, body: GraphNode, opts?: Omit<ForEachGraphNode, "type" | "over" | "body">): ForEachGraphNode;
+export declare function edge(from: string, to: string): StaticEdge;
+/** Attach a conditional edge to `from`. Pass a predicate builder or a router. */
+export declare function branch(from: string, spec: Branch | PredicateBuilder): ConditionalEdge;
+/** A sandboxed router transform that returns a next-node key (or END). */
+export declare function router(transform: TransformRef, targets: string[]): Branch;
+/**
+ * Fluent declarative predicate: `when("draft_ok", "==", true).then("END").else("write")`.
+ * Unary ops (`exists`/`truthy`/`falsy`) omit the value.
+ */
+export declare function when(channel: string, op: BranchOp, value?: unknown): PredicateBuilder;
+export declare class PredicateBuilder {
+    private readonly predicate;
+    private thenKey?;
+    private elseKey?;
+    constructor(predicate: BranchPredicate);
+    then(nodeKey: string): this;
+    else(nodeKey: string): this;
+    /** @internal */
+    build(): Branch;
+}
+export interface DefineGraphConfig {
+    name: string;
+    description?: string;
+    state: Record<string, ChannelDescriptor>;
+    nodes: Record<string, GraphNode>;
+    entry: string;
+    edges: GraphEdge[];
+    recursionLimit?: number;
+    toolFailureMode?: "strict" | "best_effort";
+    tags?: string[];
+}
+/** A locally-assembled graph, ready to `curator.graphs.create(...)`. */
+export interface GraphDraft {
+    name: string;
+    description?: string;
+    tags?: string[];
+    spec: GraphSpec;
+}
+/** Assemble a serializable graph spec locally. Pure — no network. */
+export declare function defineGraph(config: DefineGraphConfig): GraphDraft;
+export interface GraphRunOptions {
+    /** Target environment for the deployed spec (default: the client default). */
+    environment?: Environment;
+    /** Run the draft spec instead of the live deployed version. */
+    useDraft?: boolean;
+    /** Sync-wait timeout, in ms (server-capped). Only used by `run` (non-stream). */
+    timeoutMs?: number;
+}
+export interface GraphRunResult {
+    runId: string;
+    status: GraphRunStatus | "timeout";
+    state?: Record<string, unknown>;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface DeployGraphOptions {
+    environment?: Environment;
+    slug?: string;
+    changeSummary?: string;
+    /** Optimistic-concurrency token — the draft revision you reviewed. */
+    expectedDraftRevision: number;
+}
+/** A handle to one graph resource, addressed by its `graph_id`. */
+export declare class Graph {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly defaultTimeoutMs;
+    readonly graphId: string;
+    private readonly defaultEnvironment;
+    /** @internal */
+    constructor(http: HttpClient, baseUrl: string, defaultTimeoutMs: number, graphId: string, defaultEnvironment: Environment);
+    private get base();
+    /** Deploy the current draft as an immutable versioned snapshot. */
+    deploy(opts: DeployGraphOptions): Promise<{
+        versionId: string;
+        versionNumber: number;
+        slug: string;
+    }>;
+    /**
+     * Start a run and, unless `{ wait: false }`, block until it settles.
+     * Returns the terminal channel state (or `status: "timeout"` if the wait
+     * expires — the run keeps going server-side).
+     */
+    run(input: Record<string, unknown>, opts?: GraphRunOptions & {
+        wait?: boolean;
+    }): Promise<GraphRunResult>;
+    /**
+     * Start a run and stream node/state lifecycle events until it settles.
+     * Events (`run.started` / `node.started` / `node.completed` / `node.failed`
+     * / `state.delta` / `done` / `error`) are derived from the server's run-view
+     * snapshot stream. Breaking out of the loop closes the connection; the run
+     * continues server-side.
+     */
+    stream(input: Record<string, unknown>, opts?: GraphRunOptions): AsyncGenerator<GraphRunEvent, void, void>;
+    /** Fetch the read-only run projection (spec + per-node status + state). */
+    runStatus(runId: string): Promise<GraphRunView>;
+    /** List this graph's version snapshots (newest first). */
+    versions(): Promise<Array<{
+        versionId: string;
+        versionNumber: number;
+        createdAt: string;
+    }>>;
+}
+/** Collection surface for creating + addressing graphs. */
+export declare class Graphs {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly defaultTimeoutMs;
+    private readonly defaultEnvironment;
+    /** @internal */
+    constructor(http: HttpClient, baseUrl: string, defaultTimeoutMs: number, defaultEnvironment: Environment);
+    /** Create a new graph resource from a draft (or inline config). Returns a
+     *  handle bound to the new `graph_id`. */
+    create(draft: GraphDraft | DefineGraphConfig): Promise<Graph>;
+    /** Reattach to an existing graph by id. */
+    get(graphId: string): Graph;
+    private handle;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/esm/graph.d.ts.map

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