@dharta/cli 0.6.77 → 0.6.78

package/node_modules/@dharta/contracts/src/tasks.ts

@@ -0,0 +1,142 @@
+/** RFC 0065 durable background-task wire contract (snake_case, server -> consumer). */
+
+export const SESSION_TASK_KINDS = ["command", "workflow", "subagent", "other"] as const;
+export const SESSION_TASK_STATUSES = [
+  "queued", "running", "succeeded", "failed", "cancelled", "interrupted",
+] as const;
+
+export const SESSION_TASK_LIMITS = {
+  idChars: 128,
+  labelChars: 240,
+  progressUnitChars: 48,
+  errorCodeChars: 128,
+} as const;
+
+export type SessionTaskKindWire = (typeof SESSION_TASK_KINDS)[number];
+export type SessionTaskStatusWire = (typeof SESSION_TASK_STATUSES)[number];
+
+export interface SessionTaskUsageWire {
+  input_tokens?: number;
+  output_tokens?: number;
+  total_tokens?: number;
+}
+
+export interface SessionTaskWire {
+  schema_version: 1;
+  task_id: string;
+  session_id: string;
+  turn_id?: string;
+  parent_task_id?: string;
+  kind: SessionTaskKindWire;
+  label: string;
+  status: SessionTaskStatusWire;
+  started_at?: string;
+  completed_at?: string;
+  progress?: { completed?: number; total?: number; unit?: string };
+  usage?: SessionTaskUsageWire;
+  tool_uses?: number;
+  transcript_anchor?: { message_id: string; activity_id?: string };
+  cancelable: boolean;
+  error_code?: string;
+}
+
+const KIND_SET = new Set<string>(SESSION_TASK_KINDS);
+const STATUS_SET = new Set<string>(SESSION_TASK_STATUSES);
+
+/** Validate an untrusted task projection before exposing it through the SDK. */
+export function parseSessionTaskWire(value: unknown): SessionTaskWire | null {
+  if (!isRecord(value) || value.schema_version !== 1) return null;
+  if (!boundedString(value.task_id, SESSION_TASK_LIMITS.idChars)) return null;
+  if (!boundedString(value.session_id, SESSION_TASK_LIMITS.idChars)) return null;
+  if (!KIND_SET.has(String(value.kind)) || !STATUS_SET.has(String(value.status))) return null;
+  if (!boundedString(value.label, SESSION_TASK_LIMITS.labelChars)) return null;
+  if (typeof value.cancelable !== "boolean") return null;
+  if (value.turn_id !== undefined && !boundedString(value.turn_id, SESSION_TASK_LIMITS.idChars)) return null;
+  if (value.parent_task_id !== undefined && !boundedString(value.parent_task_id, SESSION_TASK_LIMITS.idChars)) return null;
+  if (value.started_at !== undefined && !validTimestamp(value.started_at)) return null;
+  if (value.completed_at !== undefined && !validTimestamp(value.completed_at)) return null;
+  if (value.error_code !== undefined && !boundedString(value.error_code, SESSION_TASK_LIMITS.errorCodeChars)) return null;
+
+  const progress = parseProgress(value.progress);
+  if (value.progress !== undefined && progress === null) return null;
+  const usage = parseUsage(value.usage);
+  if (value.usage !== undefined && usage === null) return null;
+  const anchor = parseAnchor(value.transcript_anchor);
+  if (value.transcript_anchor !== undefined && anchor === null) return null;
+  if (value.tool_uses !== undefined && !nonNegativeInteger(value.tool_uses)) return null;
+
+  return {
+    schema_version: 1,
+    task_id: value.task_id as string,
+    session_id: value.session_id as string,
+    ...(value.turn_id !== undefined ? { turn_id: value.turn_id as string } : {}),
+    ...(value.parent_task_id !== undefined ? { parent_task_id: value.parent_task_id as string } : {}),
+    kind: value.kind as SessionTaskKindWire,
+    label: value.label as string,
+    status: value.status as SessionTaskStatusWire,
+    ...(value.started_at !== undefined ? { started_at: value.started_at as string } : {}),
+    ...(value.completed_at !== undefined ? { completed_at: value.completed_at as string } : {}),
+    ...(progress ? { progress } : {}),
+    ...(usage ? { usage } : {}),
+    ...(value.tool_uses !== undefined ? { tool_uses: value.tool_uses as number } : {}),
+    ...(anchor ? { transcript_anchor: anchor } : {}),
+    cancelable: value.cancelable,
+    ...(value.error_code !== undefined ? { error_code: value.error_code as string } : {}),
+  };
+}
+
+function parseProgress(value: unknown): SessionTaskWire["progress"] | null {
+  if (value === undefined) return null;
+  if (!isRecord(value)) return null;
+  if (value.completed !== undefined && !nonNegativeNumber(value.completed)) return null;
+  if (value.total !== undefined && !nonNegativeNumber(value.total)) return null;
+  if (value.unit !== undefined && !boundedString(value.unit, SESSION_TASK_LIMITS.progressUnitChars)) return null;
+  return {
+    ...(value.completed !== undefined ? { completed: value.completed as number } : {}),
+    ...(value.total !== undefined ? { total: value.total as number } : {}),
+    ...(value.unit !== undefined ? { unit: value.unit as string } : {}),
+  };
+}
+
+function parseUsage(value: unknown): SessionTaskUsageWire | null {
+  if (value === undefined) return null;
+  if (!isRecord(value)) return null;
+  const output: SessionTaskUsageWire = {};
+  for (const key of ["input_tokens", "output_tokens", "total_tokens"] as const) {
+    if (value[key] !== undefined) {
+      if (!nonNegativeInteger(value[key])) return null;
+      output[key] = value[key] as number;
+    }
+  }
+  return output;
+}
+
+function parseAnchor(value: unknown): SessionTaskWire["transcript_anchor"] | null {
+  if (value === undefined) return null;
+  if (!isRecord(value) || !boundedString(value.message_id, SESSION_TASK_LIMITS.idChars)) return null;
+  if (value.activity_id !== undefined && !boundedString(value.activity_id, SESSION_TASK_LIMITS.idChars)) return null;
+  return {
+    message_id: value.message_id,
+    ...(value.activity_id !== undefined ? { activity_id: value.activity_id as string } : {}),
+  };
+}
+
+function validTimestamp(value: unknown): value is string {
+  return boundedString(value, 64) && Number.isFinite(Date.parse(value));
+}
+
+function boundedString(value: unknown, max: number): value is string {
+  return typeof value === "string" && value.length > 0 && value.length <= max;
+}
+
+function nonNegativeInteger(value: unknown): value is number {
+  return Number.isSafeInteger(value) && (value as number) >= 0;
+}
+
+function nonNegativeNumber(value: unknown): value is number {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/node_modules/@dharta/contracts/src/wire-events.ts

@@ -0,0 +1,150 @@
+// The canonical data-plane SSE wire-event vocabulary: the `event:` type strings
+// the Dharta data plane emits over the streaming turn endpoint, plus the raw
+// `data` shapes a client decodes. This is the cross-plane contract - the Python
+// data plane emits these, the TypeScript widget consumes them, and a conformance
+// test on each side pins both against `wire-events.json` so they cannot drift.
+//
+// These are the RAW wire shapes (snake_case, flat optional bags), not the
+// widget's normalized client-facing `AgentEvent`. The widget maps wire -> normal
+// in its transport layer; that normalization is widget-internal and not part of
+// this contract.
+
+import type { ActivityPresentationWire } from "./activity.js";
+import type { SessionTaskWire } from "./tasks.js";
+
+/**
+ * Managed-Agents adapter event types (the default, full-fidelity stream).
+ * Keep in sync with `wire-events.json` (the language-neutral source of truth a
+ * test asserts against) and the Python `MANAGED_AGENT_EVENT_TYPES`.
+ */
+export const MANAGED_AGENT_EVENT_TYPES = [
+  "session.status_running",
+  "session.trace",
+  "session.warming",
+  "agent.message",
+  "agent.thinking",
+  "agent.activity",
+  "agent.tool_use",
+  "agent.tool_result",
+  "session.usage",
+  "session.status_idle",
+  "session.error",
+  // RFC 0060 H2: a non-terminal session-level warning (e.g. the post-turn durable snapshot
+  // was refused at the storage hard cap, so recent changes were not saved).
+  "session.warning",
+  // Session message inbox: a user.message posted mid-turn is queued (never 409ed).
+  // message_dequeued's `mode` is "steered" (injected into the live turn) or "turn"
+  // (it began the next turn, incl. inbox drain at turn end). Both non-terminal.
+  "session.message_queued",
+  "session.message_dequeued",
+  "session.task_started",
+  "session.task_updated",
+  "session.task_completed",
+  "artifact.committed",
+] as const;
+
+export type ManagedAgentEventType = (typeof MANAGED_AGENT_EVENT_TYPES)[number];
+
+/** Responses adapter event types (the portable OpenAI-compatible fallback). */
+export const RESPONSES_EVENT_TYPES = [
+  "response.created",
+  "response.output_text.delta",
+  "response.completed",
+  "response.failed",
+] as const;
+
+export type ResponsesEventType = (typeof RESPONSES_EVENT_TYPES)[number];
+
+export type TurnFailurePhase =
+  | "admission"
+  | "resolution"
+  | "dispatch"
+  | "streaming"
+  | "finalization"
+  | "continuation";
+
+export type TurnFailureRemediation =
+  | "retry"
+  | "retry_turn"
+  | "reconnect_model"
+  | "select_model_funding"
+  | "start_new_session"
+  | "wait_and_retry"
+  | "contact_support"
+  | "none";
+
+export interface TurnFailureWire {
+  code?: string;
+  message?: string;
+  retryable?: boolean;
+  phase?: TurnFailurePhase;
+  remediation?: TurnFailureRemediation;
+  request_id?: string;
+}
+
+/**
+ * A raw Managed-Agents SSE event, decoded from `event:<type>\ndata:{...}`. A
+ * flat bag of optional fields because which ones are present depends on `type`
+ * (see MANAGED_AGENT_EVENT_TYPES); the consumer narrows on `type`.
+ */
+export interface ManagedAgentWireEvent extends TurnFailureWire {
+  type: string;
+  seq?: number;
+  text?: string;
+  part_id?: string;
+  // On `agent.message` / `agent.thinking`: when true, `text` is an INCREMENTAL
+  // delta to APPEND to the part (the OpenAI-compatible streaming contract, e.g.
+  // goose). Absent/false = full-message-so-far snapshot the client REPLACEs.
+  delta?: boolean;
+  tool?: string;
+  tool_use_id?: string;
+  input?: unknown;
+  output?: unknown;
+  is_error?: boolean;
+  // MCP-UI (SEP-1865) metadata on a tool_result, when present.
+  _meta?: unknown;
+  stop_reason?: string;
+  request_id?: string;
+  // On a requires_action idle: "tool_permission" (approve/deny) vs
+  // "user_question" (AskUserQuestion — answer via result="answer").
+  kind?: string;
+  target?: string;
+  options?: unknown;
+  // On a requires_action idle with kind "user_question": the AskUserQuestion
+  // questions array ({question, header, options[{label, description}],
+  // multiSelect}) so the client renders the choices.
+  questions?: unknown;
+  usage?: Record<string, unknown>;
+  turn_id?: string;
+  started_at?: string;
+  observed_at?: string;
+  completed_at?: string;
+  // The turn's W3C trace id (32-hex), on a `session.trace` event. Lets a client
+  // deep-link this turn to its trace in the org's observability backend (RFC 0053
+  // A5). Present only when the data plane has OpenTelemetry configured.
+  trace_id?: string;
+  // Session message inbox (session.message_queued / session.message_dequeued):
+  // the inbox entry id, and on dequeue how it left — "steered" (injected into
+  // the live turn) or "turn" (it began the next foreground turn).
+  queue_id?: string;
+  queued_at?: string;
+  mode?: string;
+  artifact?: Record<string, unknown>;
+  // RFC 0065: bounded semantic projection of this visible tool event. Raw
+  // input/output remain additive for headless compatibility.
+  activity?: ActivityPresentationWire;
+  task?: SessionTaskWire;
+  task_seq?: number;
+  version?: number;
+}
+
+/** A raw Responses-adapter SSE event (OpenAI-compatible response stream). */
+export interface ResponsesWireEvent {
+  type: string;
+  delta?: string;
+  response?: {
+    id?: string;
+    usage?: Record<string, unknown>;
+    error?: TurnFailureWire;
+  };
+}

package/node_modules/@dharta/contracts/wire-events.json

@@ -0,0 +1,29 @@
+{
+  "_comment": "Canonical data-plane SSE wire-event vocabulary. Language-neutral source of truth. The TypeScript consts in src/wire-events.ts and the Python MANAGED_AGENT_EVENT_TYPES / RESPONSES_EVENT_TYPES are each asserted to match this file by a conformance test, so the two planes cannot drift. Edit here first, then both sides.",
+  "managed_agents": [
+    "session.status_running",
+    "session.trace",
+    "session.warming",
+    "agent.message",
+    "agent.thinking",
+    "agent.activity",
+    "agent.tool_use",
+    "agent.tool_result",
+    "session.usage",
+    "session.status_idle",
+    "session.error",
+    "session.warning",
+    "session.message_queued",
+    "session.message_dequeued",
+    "session.task_started",
+    "session.task_updated",
+    "session.task_completed",
+    "artifact.committed"
+  ],
+  "responses": [
+    "response.created",
+    "response.output_text.delta",
+    "response.completed",
+    "response.failed"
+  ]
+}

package/node_modules/@dharta/sdk/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 LifeSage LLC
+Copyright (c) 2026 Dharta Labs, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/node_modules/@dharta/sdk/README.md

@@ -29,7 +29,20 @@ const { api_key, secret } = await dharta.apiKeys.create("ci-runner", ["write"]);
 console.log("Store this now, it won't be shown again:", secret);
 
 // Store a BYOK provider key (encrypted at rest server-side)
-await dharta.modelKeys.create("anthropic", process.env.ANTHROPIC_API_KEY!, "primary");
+await dharta.modelConnections.create("anthropic", process.env.ANTHROPIC_API_KEY!, "primary");
+
+// Address a connector by its numeric id or its organization-unique slug
+await dharta.modelConnections.rotate("anthropic-primary", { plaintext: process.env.ANTHROPIC_API_KEY! });
+await dharta.modelConnections.configureModels("anthropic-primary", {
+  enabled: ["claude-sonnet-5"],
+  default: "claude-sonnet-5",
+});
+
+// Organization defaults every agent inherits
+await dharta.organization.modelSettings.update({
+  connector_order: ["anthropic-primary", "karta"],
+  model_reference: "claude-sonnet-5",
+});
 
 // Manage webhook endpoints
 const { webhook_endpoint, secret: signingSecret } = await dharta.webhookEndpoints.create({
@@ -44,16 +57,16 @@ const billing = await dharta.billing.status();
 
 ## Errors
 
-Every 4xx/5xx response throws a typed `KartaError` subclass that
+Every 4xx/5xx response throws a typed `DhartaError` subclass that
 preserves `status` and the parsed JSON `body`:
 
 ```ts
-import { KartaValidationError } from "@dharta/sdk";
+import { DhartaValidationError } from "@dharta/sdk";
 
 try {
   await dharta.apiKeys.create("");
 } catch (e) {
-  if (e instanceof KartaValidationError) {
+  if (e instanceof DhartaValidationError) {
     console.warn(e.body); // { error: "validation_failed", message: "Name is required" }
   } else {
     throw e;
@@ -61,9 +74,9 @@ try {
 }
 ```
 
-Subclasses: `KartaAuthError` (401), `KartaForbiddenError` (403),
-`KartaNotFoundError` (404), `KartaValidationError` (422). Anything
-else throws the base `KartaError`.
+Subclasses: `DhartaAuthError` (401), `DhartaForbiddenError` (403),
+`DhartaNotFoundError` (404), `DhartaValidationError` (422). Anything
+else throws the base `DhartaError`.
 
 ## Development
 
@@ -78,7 +91,8 @@ npm test        # vitest against a stub fetch
 | Resource             | Methods                                                                |
 | -------------------- | ---------------------------------------------------------------------- |
 | `apiKeys`            | `list()`, `create(name, scopes?)`, `revoke(id)`                        |
-| `modelKeys`          | `list()`, `create(provider, plaintext, name?)`, `revoke(id)`           |
+| `modelConnections`          | `list()`, `create(provider, plaintext, name?)`, `rotate(idOrSlug, params)`, `models(idOrSlug)`, `configureModels(idOrSlug, params)`, `revoke(id)` |
+| `organization.modelSettings` | `get()`, `update(params)`                                      |
 | `webhookEndpoints`   | `list()`, `create(params)`, `update(id, params)`, `enable(id)`, `delete(id)` |
 | `usage`              | `summary()`                                                            |
 | `billing`            | `status()`                                                             |

package/node_modules/@dharta/sdk/dist/errors.d.ts

@@ -1,20 +1,22 @@
 import type { ErrorBody } from "./types.js";
-export declare class KartaError extends Error {
+export declare class DhartaError extends Error {
     readonly status: number;
     readonly body: ErrorBody | string | null;
-    constructor(message: string, status: number, body: ErrorBody | string | null);
+    readonly retryAfterSeconds?: number;
+    constructor(message: string, status: number, body: ErrorBody | string | null, retryAfterSeconds?: number);
 }
-export declare class KartaAuthError extends KartaError {
+export declare class DhartaAuthError extends DhartaError {
     constructor(body: ErrorBody | string | null);
 }
-export declare class KartaForbiddenError extends KartaError {
+export declare class DhartaForbiddenError extends DhartaError {
     constructor(body: ErrorBody | string | null);
 }
-export declare class KartaNotFoundError extends KartaError {
+export declare class DhartaNotFoundError extends DhartaError {
     constructor(body: ErrorBody | string | null);
 }
-export declare class KartaValidationError extends KartaError {
+export declare class DhartaValidationError extends DhartaError {
     constructor(body: ErrorBody | string | null);
 }
-export declare function errorFor(status: number, body: ErrorBody | string | null): KartaError;
+export declare function errorFor(status: number, body: ErrorBody | string | null, retryAfterSeconds?: number): DhartaError;
+export declare function parseRetryAfterSeconds(header: string | null): number | undefined;
 //# sourceMappingURL=errors.d.ts.map

package/node_modules/@dharta/sdk/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAEzC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAK3E;CACF;AAED,qBAAa,cAAe,SAAQ,UAAU;IAC5C,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,GAC9B,UAAU,CAUZ"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAMzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,YACE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAC/B,iBAAiB,CAAC,EAAE,MAAM,EAO3B;CACF;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAC9C,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,qBAAa,oBAAqB,SAAQ,WAAW;IACnD,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,qBAAa,qBAAsB,SAAQ,WAAW;IACpD,YAAY,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAG1C;CACF;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,EAC/B,iBAAiB,CAAC,EAAE,MAAM,GACzB,WAAW,CAUb;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAMhF"}

package/node_modules/@dharta/sdk/dist/errors.js

@@ -1,51 +1,69 @@
-// Base class so consumers can `catch (e: KartaError)` without
+// Base class so consumers can `catch (e: DhartaError)` without
 // switching on status codes manually for the common cases.
-export class KartaError extends Error {
+export class DhartaError extends Error {
     status;
     body;
-    constructor(message, status, body) {
+    // Seconds the server asked the caller to wait, from the `Retry-After`
+    // header, when it sent one. Undefined otherwise, including when the header
+    // is an HTTP-date rather than a delay: a caller that wants to sleep needs a
+    // number, and guessing one from a clock this client cannot trust is worse
+    // than saying nothing. Only 429 sends it today.
+    retryAfterSeconds;
+    constructor(message, status, body, retryAfterSeconds) {
         super(message);
-        this.name = "KartaError";
+        this.name = "DhartaError";
         this.status = status;
         this.body = body;
+        this.retryAfterSeconds = retryAfterSeconds;
     }
 }
-export class KartaAuthError extends KartaError {
+export class DhartaAuthError extends DhartaError {
     constructor(body) {
         super("Unauthenticated or invalid API key", 401, body);
-        this.name = "KartaAuthError";
+        this.name = "DhartaAuthError";
     }
 }
-export class KartaForbiddenError extends KartaError {
+export class DhartaForbiddenError extends DhartaError {
     constructor(body) {
         super("Forbidden — caller lacks required scope", 403, body);
-        this.name = "KartaForbiddenError";
+        this.name = "DhartaForbiddenError";
     }
 }
-export class KartaNotFoundError extends KartaError {
+export class DhartaNotFoundError extends DhartaError {
     constructor(body) {
         super("Resource not found", 404, body);
-        this.name = "KartaNotFoundError";
+        this.name = "DhartaNotFoundError";
     }
 }
-export class KartaValidationError extends KartaError {
+export class DhartaValidationError extends DhartaError {
     constructor(body) {
         super("Validation failed", 422, body);
-        this.name = "KartaValidationError";
+        this.name = "DhartaValidationError";
     }
 }
-export function errorFor(status, body) {
+export function errorFor(status, body, retryAfterSeconds) {
     if (status === 401)
-        return new KartaAuthError(body);
+        return new DhartaAuthError(body);
     if (status === 403)
-        return new KartaForbiddenError(body);
+        return new DhartaForbiddenError(body);
     if (status === 404)
-        return new KartaNotFoundError(body);
+        return new DhartaNotFoundError(body);
     if (status === 422)
-        return new KartaValidationError(body);
+        return new DhartaValidationError(body);
     const msg = body && typeof body === "object" && "message" in body && body.message
         ? body.message
         : `Dharta API error ${status}`;
-    return new KartaError(String(msg), status, body);
+    return new DhartaError(String(msg), status, body, retryAfterSeconds);
+}
+// `Retry-After` as a whole number of seconds, or undefined when the header is
+// absent, an HTTP-date, or otherwise not a non-negative integer count.
+export function parseRetryAfterSeconds(header) {
+    if (header === null)
+        return undefined;
+    const trimmed = header.trim();
+    if (!/^\d+$/.test(trimmed))
+        return undefined;
+    const seconds = Number(trimmed);
+    return Number.isFinite(seconds) ? seconds : undefined;
 }
 //# sourceMappingURL=errors.js.map

package/node_modules/@dharta/sdk/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,2DAA2D;AAC3D,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,MAAM,CAAS;IACf,IAAI,CAA4B;IAEzC,YAAY,OAAe,EAAE,MAAc,EAAE,IAA+B;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,IAA+B;QACzC,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,YAAY,IAA+B;QACzC,KAAK,CAAC,yCAAyC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,IAA+B;QACzC,KAAK,CAAC,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAY,IAA+B;QACzC,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,IAA+B;IAE/B,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,GAAG,GACP,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO;QACnE,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,oBAAoB,MAAM,EAAE,CAAC;IACnC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,2DAA2D;AAC3D,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,MAAM,CAAS;IACf,IAAI,CAA4B;IACzC,sEAAsE;IACtE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,gDAAgD;IACvC,iBAAiB,CAAU;IAEpC,YACE,OAAe,EACf,MAAc,EACd,IAA+B,EAC/B,iBAA0B;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,IAA+B;QACzC,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,IAA+B;QACzC,KAAK,CAAC,yCAAyC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,IAA+B;QACzC,KAAK,CAAC,oBAAoB,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,IAA+B;QACzC,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,UAAU,QAAQ,CACtB,MAAc,EACd,IAA+B,EAC/B,iBAA0B;IAE1B,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,GAAG,GACP,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO;QACnE,CAAC,CAAC,IAAI,CAAC,OAAO;QACd,CAAC,CAAC,oBAAoB,MAAM,EAAE,CAAC;IACnC,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED,8EAA8E;AAC9E,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,MAAqB;IAC1D,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/node_modules/@dharta/sdk/dist/fleet.d.ts

@@ -0,0 +1,69 @@
+import type { HttpClient } from "./http.js";
+import type { MutationOptions } from "./idempotency.js";
+import type { FleetAnomalyFinding, FleetExportParams, FleetOperation, FleetOperationParams, FleetRollout, FleetSavedView, FleetSavedViewParams, FleetSnoozeDuration, FleetAnalyticsSaveParams } from "./types.js";
+export interface FleetRollbackResult {
+    rollout: FleetRollout;
+    operation: FleetOperation;
+}
+export declare class FleetOperationsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: FleetOperationParams, options?: MutationOptions): Promise<FleetOperation>;
+    confirm(id: string, phrase: string, options?: MutationOptions): Promise<FleetOperation>;
+    cancel(id: string, options?: MutationOptions): Promise<FleetOperation>;
+    retry(id: string, options?: MutationOptions): Promise<FleetOperation>;
+    private post;
+}
+export declare class FleetRolloutsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    advance(id: string, options?: MutationOptions): Promise<FleetRollout>;
+    pause(id: string, options?: MutationOptions): Promise<FleetRollout>;
+    resume(id: string, options?: MutationOptions): Promise<FleetRollout>;
+    evaluate(id: string, options?: MutationOptions): Promise<FleetRollout>;
+    rollback(id: string, options?: MutationOptions): Promise<FleetRollbackResult>;
+    private post;
+}
+export declare class FleetFindingsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    acknowledge(id: string, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    snooze(id: string, duration?: FleetSnoozeDuration, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    resolve(id: string, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    reopen(id: string, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    classify(id: string, classification: string, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    assign(id: string, membershipId?: number | string | null, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    promote(id: string, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    updateRunbook(id: string, runbookUrl: string | null, options?: MutationOptions): Promise<FleetAnomalyFinding>;
+    private post;
+}
+export declare class FleetSavedViewsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: FleetSavedViewParams, options?: MutationOptions): Promise<FleetSavedView>;
+    update(id: string, params: Partial<FleetSavedViewParams>, options?: MutationOptions): Promise<FleetSavedView>;
+    delete(id: string, options?: MutationOptions): Promise<void>;
+    favorite(id: string, options?: MutationOptions): Promise<void>;
+    unfavorite(id: string, options?: MutationOptions): Promise<void>;
+}
+export declare class FleetAnalyticsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    save(params: FleetAnalyticsSaveParams, options?: MutationOptions): Promise<FleetSavedView>;
+    unpin(id: string, options?: MutationOptions): Promise<void>;
+}
+export declare class FleetExportsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(params: FleetExportParams, options?: MutationOptions): Promise<string>;
+}
+export declare class FleetResource {
+    readonly operations: FleetOperationsResource;
+    readonly rollouts: FleetRolloutsResource;
+    readonly findings: FleetFindingsResource;
+    readonly savedViews: FleetSavedViewsResource;
+    readonly analytics: FleetAnalyticsResource;
+    readonly exports: FleetExportsResource;
+    constructor(http: HttpClient);
+}
+//# sourceMappingURL=fleet.d.ts.map

package/node_modules/@dharta/sdk/dist/fleet.d.ts.map

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