@dharta/cli 0.6.77 → 0.6.78

package/node_modules/@dharta/contracts/dist/tasks.js

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

package/node_modules/@dharta/contracts/dist/tasks.js.map

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

package/node_modules/@dharta/contracts/dist/wire-events.d.ts

@@ -0,0 +1,71 @@
+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 declare const MANAGED_AGENT_EVENT_TYPES: readonly ["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"];
+export type ManagedAgentEventType = (typeof MANAGED_AGENT_EVENT_TYPES)[number];
+/** Responses adapter event types (the portable OpenAI-compatible fallback). */
+export declare const RESPONSES_EVENT_TYPES: readonly ["response.created", "response.output_text.delta", "response.completed", "response.failed"];
+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;
+    delta?: boolean;
+    tool?: string;
+    tool_use_id?: string;
+    input?: unknown;
+    output?: unknown;
+    is_error?: boolean;
+    _meta?: unknown;
+    stop_reason?: string;
+    request_id?: string;
+    kind?: string;
+    target?: string;
+    options?: unknown;
+    questions?: unknown;
+    usage?: Record<string, unknown>;
+    turn_id?: string;
+    started_at?: string;
+    observed_at?: string;
+    completed_at?: string;
+    trace_id?: string;
+    queue_id?: string;
+    queued_at?: string;
+    mode?: string;
+    artifact?: Record<string, unknown>;
+    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;
+    };
+}
+//# sourceMappingURL=wire-events.d.ts.map

package/node_modules/@dharta/contracts/dist/wire-events.d.ts.map

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

package/node_modules/@dharta/contracts/dist/wire-events.js

@@ -0,0 +1,48 @@
+// 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.
+/**
+ * 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",
+];
+/** Responses adapter event types (the portable OpenAI-compatible fallback). */
+export const RESPONSES_EVENT_TYPES = [
+    "response.created",
+    "response.output_text.delta",
+    "response.completed",
+    "response.failed",
+];
+//# sourceMappingURL=wire-events.js.map

package/node_modules/@dharta/contracts/dist/wire-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-events.js","sourceRoot":"","sources":["../src/wire-events.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,EAAE;AACF,0EAA0E;AAC1E,iFAAiF;AACjF,gFAAgF;AAChF,iBAAiB;AAKjB;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,wBAAwB;IACxB,eAAe;IACf,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,mBAAmB;IACnB,eAAe;IACf,qBAAqB;IACrB,eAAe;IACf,yFAAyF;IACzF,0EAA0E;IAC1E,iBAAiB;IACjB,iFAAiF;IACjF,iFAAiF;IACjF,8EAA8E;IAC9E,wBAAwB;IACxB,0BAA0B;IAC1B,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,oBAAoB;CACZ,CAAC;AAIX,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,kBAAkB;IAClB,4BAA4B;IAC5B,oBAAoB;IACpB,iBAAiB;CACT,CAAC"}

package/node_modules/@dharta/contracts/model-auth-capabilities-v1.json

@@ -0,0 +1,168 @@
+{
+  "schema_version": 1,
+  "credential_kinds": [
+    "api_key",
+    "oauth_session",
+    "provider_managed_session",
+    "workload_identity"
+  ],
+  "funding_sources": [
+    "api_usage",
+    "subscription_entitlement",
+    "enterprise_entitlement",
+    "platform"
+  ],
+  "owner_kinds": [
+    "organization",
+    "individual",
+    "install",
+    "platform"
+  ],
+  "storage_kinds": [
+    "control_plane_encrypted",
+    "install_local_ref",
+    "os_keyring",
+    "provider_client_owned"
+  ],
+  "execution_scopes": [
+    "local",
+    "private_interactive",
+    "background",
+    "shared",
+    "public"
+  ],
+  "capabilities": [
+    {
+      "id": "anthropic_api_key",
+      "provider": "anthropic",
+      "credential_kind": "api_key",
+      "funding_source": "api_usage",
+      "owner_kinds": ["organization", "individual"],
+      "storage_kinds": ["control_plane_encrypted", "install_local_ref", "os_keyring"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "anthropic_api_key",
+      "adapter": "anthropic_api_key"
+    },
+    {
+      "id": "openai_api_key",
+      "provider": "openai",
+      "credential_kind": "api_key",
+      "funding_source": "api_usage",
+      "owner_kinds": ["organization", "individual"],
+      "storage_kinds": ["control_plane_encrypted", "install_local_ref", "os_keyring"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "openai_api_key",
+      "adapter": "openai_api_key"
+    },
+    {
+      "id": "openrouter_api_key",
+      "provider": "openrouter",
+      "credential_kind": "api_key",
+      "funding_source": "api_usage",
+      "owner_kinds": ["organization", "individual"],
+      "storage_kinds": ["control_plane_encrypted", "install_local_ref", "os_keyring"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "openrouter_api_key",
+      "adapter": "openrouter_api_key"
+    },
+    {
+      "id": "xai_api_key",
+      "provider": "xai",
+      "credential_kind": "api_key",
+      "funding_source": "api_usage",
+      "owner_kinds": ["organization", "individual"],
+      "storage_kinds": ["control_plane_encrypted", "install_local_ref", "os_keyring"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "xai_api_key",
+      "adapter": "xai_api_key"
+    },
+    {
+      "id": "google_api_key",
+      "provider": "google",
+      "credential_kind": "api_key",
+      "funding_source": "api_usage",
+      "owner_kinds": ["organization", "individual"],
+      "storage_kinds": ["control_plane_encrypted", "install_local_ref", "os_keyring"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "google_api_key",
+      "adapter": "google_api_key"
+    },
+    {
+      "id": "bedrock_workload_identity",
+      "provider": "bedrock",
+      "credential_kind": "workload_identity",
+      "funding_source": "platform",
+      "owner_kinds": ["platform"],
+      "storage_kinds": ["provider_client_owned"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "bedrock_workload_identity",
+      "adapter": "bedrock_workload_identity"
+    },
+    {
+      "id": "vertex_workload_identity",
+      "provider": "vertex",
+      "credential_kind": "workload_identity",
+      "funding_source": "platform",
+      "owner_kinds": ["platform"],
+      "storage_kinds": ["provider_client_owned"],
+      "execution_scopes": ["local", "private_interactive", "background", "shared", "public"],
+      "admission": "enabled",
+      "runtime_switch": "vertex_workload_identity",
+      "adapter": "vertex_workload_identity"
+    },
+    {
+      "id": "anthropic_claude_local_subscription",
+      "provider": "anthropic",
+      "credential_kind": "provider_managed_session",
+      "funding_source": "subscription_entitlement",
+      "owner_kinds": ["individual"],
+      "storage_kinds": ["provider_client_owned"],
+      "execution_scopes": ["local"],
+      "admission": "enabled",
+      "runtime_switch": "anthropic_claude_local_subscription",
+      "adapter": "anthropic_claude_local"
+    },
+    {
+      "id": "openai_codex_hosted_subscription",
+      "provider": "openai",
+      "credential_kind": "provider_managed_session",
+      "funding_source": "subscription_entitlement",
+      "owner_kinds": ["individual"],
+      "storage_kinds": ["provider_client_owned"],
+      "execution_scopes": ["private_interactive"],
+      "admission": "enabled",
+      "runtime_switch": "openai_codex_hosted_subscription",
+      "adapter": "openai_codex_app_server"
+    },
+    {
+      "id": "xai_grok_hosted_subscription",
+      "provider": "xai",
+      "credential_kind": "provider_managed_session",
+      "funding_source": "subscription_entitlement",
+      "owner_kinds": ["individual"],
+      "storage_kinds": ["provider_client_owned"],
+      "execution_scopes": ["private_interactive"],
+      "admission": "enabled",
+      "runtime_switch": "xai_grok_hosted_subscription",
+      "adapter": "xai_grok_build_acp"
+    },
+    {
+      "id": "anthropic_claude_hosted_subscription",
+      "provider": "anthropic",
+      "credential_kind": "provider_managed_session",
+      "funding_source": "subscription_entitlement",
+      "owner_kinds": ["individual"],
+      "storage_kinds": ["provider_client_owned"],
+      "execution_scopes": [],
+      "admission": "disabled",
+      "runtime_switch": "anthropic_claude_hosted_subscription",
+      "adapter": null
+    }
+  ]
+}

package/node_modules/@dharta/contracts/model-auth-reasons-v1.json

@@ -0,0 +1,38 @@
+{
+  "schema_version": 1,
+  "precedence": [
+    "model_auth_revoked",
+    "model_auth_capability_disabled",
+    "model_auth_missing",
+    "model_auth_expired",
+    "model_auth_refresh_outcome_indeterminate",
+    "model_auth_reauthorization_required",
+    "model_auth_account_mismatch",
+    "model_auth_refresh_failed",
+    "model_auth_entitlement_exhausted",
+    "model_auth_scope_ineligible",
+    "model_auth_funding_selection_required",
+    "model_auth_new_session_required",
+    "model_auth_adapter_unavailable",
+    "model_auth_misconfigured",
+    "model_auth_provider_unavailable"
+  ],
+  "reasons": [
+    {"code": "model_auth_missing", "fails_turn": true, "stage": "authorization", "retry_class": "after_reauthorization"},
+    {"code": "model_auth_expiring", "fails_turn": false, "stage": "authorization", "retry_class": "never"},
+    {"code": "model_auth_expired", "fails_turn": true, "stage": "authorization", "retry_class": "after_reauthorization"},
+    {"code": "model_auth_refresh_failed", "fails_turn": true, "stage": "authorization", "retry_class": "provider_later"},
+    {"code": "model_auth_reauthorization_required", "fails_turn": true, "stage": "authorization", "retry_class": "after_reauthorization"},
+    {"code": "model_auth_refresh_outcome_indeterminate", "fails_turn": true, "stage": "authorization", "retry_class": "after_reauthorization"},
+    {"code": "model_auth_entitlement_exhausted", "fails_turn": true, "stage": "authorization", "retry_class": "provider_later"},
+    {"code": "model_auth_revoked", "fails_turn": true, "stage": "policy", "retry_class": "after_policy_change"},
+    {"code": "model_auth_capability_disabled", "fails_turn": true, "stage": "policy", "retry_class": "after_policy_change"},
+    {"code": "model_auth_scope_ineligible", "fails_turn": true, "stage": "policy", "retry_class": "after_policy_change"},
+    {"code": "model_auth_funding_selection_required", "fails_turn": true, "stage": "authorization", "retry_class": "never"},
+    {"code": "model_auth_new_session_required", "fails_turn": true, "stage": "authorization", "retry_class": "never"},
+    {"code": "model_auth_account_mismatch", "fails_turn": true, "stage": "authorization", "retry_class": "after_reauthorization"},
+    {"code": "model_auth_adapter_unavailable", "fails_turn": true, "stage": "policy", "retry_class": "after_policy_change"},
+    {"code": "model_auth_misconfigured", "fails_turn": true, "stage": "setup", "retry_class": "operator_intervention"},
+    {"code": "model_auth_provider_unavailable", "fails_turn": true, "stage": "dispatch", "retry_class": "provider_later"}
+  ]
+}

package/node_modules/@dharta/contracts/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@dharta/contracts",
+  "version": "0.1.0",
+  "description": "Dharta wire and executable-Artifact contracts shared across TypeScript and the Python data plane.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./wire-events.json": "./wire-events.json",
+    "./artifact-runtime.json": "./artifact-runtime.json",
+    "./model-auth-capabilities-v1.json": "./model-auth-capabilities-v1.json",
+    "./model-auth-reasons-v1.json": "./model-auth-reasons-v1.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "wire-events.json",
+    "artifact-runtime.json",
+    "model-auth-capabilities-v1.json",
+    "model-auth-reasons-v1.json",
+    "README.md"
+  ],
+  "scripts": {
+    "generate:artifact-runtime": "node scripts/generate-artifact-runtime-bindings.mjs",
+    "check:artifact-runtime": "node scripts/generate-artifact-runtime-bindings.mjs --check",
+    "prepack": "npm run build",
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "devDependencies": {
+    "ajv": "^8.20.0",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  }
+}