@inneranimalmedia/agentsam-sdk 2.6.9 → 2.6.11

package/migrations/runtime/0009_analytics_authority.sql

@@ -0,0 +1,108 @@
+-- AgentSam analytics authority v1.
+--
+-- Replace the old, empty aggregate-shaped agentsam_analytics table with the
+-- canonical HOT analytical fact ledger.
+--
+-- Safety: the guard aborts if the legacy table contains any rows.
+-- Operational tables remain authoritative for live transactional state.
+-- agentsam_analytics owns normalized analytical facts.
+-- Basin/Iceberg receives compact projections from those facts.
+
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS agentsam_analytics_migration_guard_0009 (
+  row_count INTEGER NOT NULL CHECK (row_count = 0)
+);
+
+DELETE FROM agentsam_analytics_migration_guard_0009;
+
+INSERT INTO agentsam_analytics_migration_guard_0009 (row_count)
+SELECT COUNT(*) FROM agentsam_analytics;
+
+DROP TABLE agentsam_analytics_migration_guard_0009;
+
+ALTER TABLE agentsam_analytics
+RENAME TO agentsam_analytics_aggregate_legacy_20261003;
+
+CREATE TABLE agentsam_analytics (
+  id                    TEXT PRIMARY KEY NOT NULL,
+  schema_name           TEXT NOT NULL DEFAULT 'agentsam.metric-event.v1',
+
+  account_id            TEXT,
+  tenant_id             TEXT,
+  workspace_id          TEXT,
+  repository_id         TEXT,
+  git_sha               TEXT,
+  run_id                TEXT,
+  receipt_id            TEXT,
+
+  event_kind            TEXT NOT NULL,
+  domain                TEXT NOT NULL,
+  operation             TEXT NOT NULL,
+  outcome               TEXT,
+
+  source_client         TEXT,
+  source_table          TEXT,
+  source_id             TEXT,
+  provider              TEXT,
+  model_key             TEXT,
+  tool_key              TEXT,
+
+  duration_ms           INTEGER CHECK (duration_ms IS NULL OR duration_ms >= 0),
+  queue_wait_ms         INTEGER CHECK (queue_wait_ms IS NULL OR queue_wait_ms >= 0),
+  external_wait_ms      INTEGER CHECK (external_wait_ms IS NULL OR external_wait_ms >= 0),
+  active_model_ms       INTEGER CHECK (active_model_ms IS NULL OR active_model_ms >= 0),
+
+  input_tokens          INTEGER CHECK (input_tokens IS NULL OR input_tokens >= 0),
+  cached_input_tokens   INTEGER CHECK (cached_input_tokens IS NULL OR cached_input_tokens >= 0),
+  output_tokens         INTEGER CHECK (output_tokens IS NULL OR output_tokens >= 0),
+  reasoning_tokens      INTEGER CHECK (reasoning_tokens IS NULL OR reasoning_tokens >= 0),
+  cost_usd              REAL CHECK (cost_usd IS NULL OR cost_usd >= 0),
+  cost_basis            TEXT,
+
+  attempt_count         INTEGER CHECK (attempt_count IS NULL OR attempt_count >= 0),
+  retry_count           INTEGER CHECK (retry_count IS NULL OR retry_count >= 0),
+  plan_points           REAL,
+
+  score_family          TEXT,
+  score_value           REAL,
+  weights_version       TEXT,
+
+  error_code            TEXT,
+  failure_origin        TEXT,
+  artifact_ref          TEXT,
+
+  dimensions_json       TEXT NOT NULL DEFAULT '{}',
+  metrics_json          TEXT NOT NULL DEFAULT '{}',
+
+  dedup_key             TEXT,
+  created_at_unix       INTEGER NOT NULL DEFAULT (unixepoch()),
+
+  CHECK (score_value IS NULL OR score_family IS NOT NULL),
+  CHECK (score_family IS NULL OR weights_version IS NOT NULL)
+);
+
+CREATE UNIQUE INDEX idx_agentsam_analytics_dedup
+  ON agentsam_analytics(dedup_key)
+  WHERE dedup_key IS NOT NULL;
+
+CREATE INDEX idx_agentsam_analytics_created
+  ON agentsam_analytics(created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_run
+  ON agentsam_analytics(run_id, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_repo
+  ON agentsam_analytics(repository_id, git_sha, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_domain_operation
+  ON agentsam_analytics(domain, operation, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_outcome
+  ON agentsam_analytics(outcome, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_receipt
+  ON agentsam_analytics(receipt_id);
+
+CREATE INDEX idx_agentsam_analytics_score
+  ON agentsam_analytics(score_family, weights_version, created_at_unix DESC);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-sdk",
-  "version": "2.6.9",
+  "version": "2.6.11",
   "description": "Portable AgentSam SDK and CLI kits for local scaffolding, repository intelligence, incremental indexing, identity adapters, and verified dependency maintenance.",
   "type": "module",
   "main": "./src/index.js",
@@ -60,7 +60,7 @@
     "./identity/oauth/finalize-inbound": "./packages/identity/src/oauth/finalize-inbound.js",
     "./identity/oauth/redirect-paths": "./packages/identity/src/oauth/redirect-paths.js",
     "./identity/oauth/credentials": "./packages/identity/src/oauth/credentials.js",
-    "./identity/oauth/google-desktop-exchange": "./packages/identity/src/oauth/google-desktop-exchange.js",
+    "./identity/oauth/google-desktop-exchange": "./packages/identity/src/oauth/goaude.js",
     "./identity/oauth/iam-platform": "./packages/identity/src/oauth/iam-platform.js",
     "./identity/recovery/password-reset": "./packages/identity/src/recovery/password-reset.js",
     "./identity/server/worker-router": "./packages/identity/src/server/worker-router.js",
@@ -90,6 +90,7 @@
     "./work-graph/adapters/business/projects": "./packages/work-graph/src/adapters/business/projects.js",
     "./errors": "./src/errors/index.js",
     "./errors/schema": "./protocol/errors/error-envelope.schema.json",
+    "./errors/schema-v2": "./protocol/errors/agentsam.error.v2.schema.json",
     "./errors/catalog": "./protocol/errors/error-catalog.json",
     "./cloudflare": "./src/cloudflare/index.js",
     "./eval": "./src/eval/index.js",
@@ -119,12 +120,28 @@
     "./theme/harbor": "./packages/theme-insurance-site/src/index.js",
     "./theme/summit": "./packages/theme-shinshu-site/src/index.js",
     "./models/inventory": "./src/models/inventory-core.js",
+    "./models/provider-snapshot-schema": "./protocol/models/provider-model-snapshot.v1.schema.json",
     "./local-engine": "./src/local-engine/index.js",
     "./local-engine/contracts": "./src/local-engine/contracts.js",
     "./local-engine/audit": "./src/local-engine/audit.js",
     "./local-engine/assets": "./src/local-engine/assets.js",
     "./local-engine/benchmark": "./src/local-engine/benchmark.js",
-    "./goap": "./packages/agentsam-goap/src/index.js"
+    "./goap": "./packages/agentsam-goap/src/index.js",
+    "./hooks": "./packages/agentsam-hooks/src/index.js",
+    "./hooks/store": "./packages/agentsam-hooks/src/store.js",
+    "./hooks/protocol/input": "./protocol/hooks/agentsam.hook.v1.schema.json",
+    "./hooks/protocol/output": "./protocol/hooks/agentsam.hook.output.v1.schema.json",
+    "./hooks/protocol/config": "./protocol/hooks/agentsam.hooks.config.v1.schema.json",
+    "./hooks/protocol/receipt": "./protocol/hooks/agentsam.hook.receipt.v1.schema.json",
+    "./hooks/schema/manifest": "./packages/agentsam-hooks/schema/manifest.json",
+    "./hooks/schema/sqlite": "./migrations/runtime/0005_agentsam_hooks.sql",
+    "./acp": "./src/acp/index.js",
+    "./acp/http": "./src/acp/http.js",
+    "./acp/runtime-selection": "./src/acp/runtime-selection.js",
+    "./receipts": "./src/receipts/index.js",
+    "./receipts/schema": "./protocol/receipts/agentsam.receipt.v1.json",
+    "./merch": "./packages/agentsam-merch/src/index.js",
+    "./merch/node": "./packages/agentsam-merch/src/node/index.js"
   },
   "bin": {
     "agentsam": "bin/agentsam",
@@ -132,7 +149,8 @@
     "agentsam-scaffold": "bin/scaffold.mjs",
     "agentsam-auth-portal": "packages/identity/scripts/preview-auth-portal.mjs",
     "agentsam-rapid-rust": "bin/agentsam-rapid-rust",
-    "agentsam-rust": "bin/agentsam-rapid-rust"
+    "agentsam-rust": "bin/agentsam-rapid-rust",
+    "agentsam-hooks": "packages/agentsam-hooks/bin/agentsam-hooks.mjs"
   },
   "files": [
     "src",
@@ -142,6 +160,7 @@
     "packages/agentsam-brand/bin",
     "packages/agentsam-brand/src",
     "packages/agentsam-contracts",
+    "packages/agentsam-hooks",
     "packages/agentsam-errors",
     "packages/agentsam-repository",
     "packages/agentsam-knowledge",
@@ -151,7 +170,7 @@
     "packages/work-graph",
     "packages/agentsam-queue-control",
     "packages/agentsam-goap",
-    "packages/connectors/cloudflare",
+    "packages/connectors/cfoa",
     "packages/providers/completeful",
     "templates",
     "docs",
@@ -217,9 +236,13 @@
     "packages/agentsam-workbench/package.json",
     "packages/agentsam-workbench/README.md",
     "packages/agentsam-workbench/src",
-    "packages/agentsam-workbench/tsconfig.json"
+    "packages/agentsam-workbench/tsconfig.json",
+    "packages/agentsam-merch",
+    "TRADEMARKS.md"
   ],
   "workspaces": [
+    "packages/agentsam-analytics",
+    "packages/analytics-ui",
     "packages/agentsam-assets-core",
     "packages/agentsam-brand",
     "packages/agentsam-cloudflare-images",
@@ -231,9 +254,12 @@
     "packages/agentsam-docs-theme",
     "packages/agentsam-errors",
     "packages/agentsam-goap",
+    "packages/agentsam-hooks",
     "packages/agentsam-ide",
     "packages/agentsam-key-manager",
     "packages/agentsam-knowledge",
+    "packages/agentsam-loading-scene",
+    "packages/agentsam-merch",
     "packages/agentsam-nav",
     "packages/agentsam-queue-control",
     "packages/agentsam-repository",
@@ -244,7 +270,7 @@
     "packages/agentsam-work",
     "packages/agentsam-workbench",
     "packages/cms-runtime",
-    "packages/connectors/cloudflare",
+    "packages/connectors/cfoa",
     "packages/heuristic-theme",
     "packages/identity",
     "packages/providers/completeful",
@@ -257,11 +283,15 @@
     "packages/theme-insurance-site",
     "packages/theme-scenes",
     "packages/theme-shinshu-site",
-    "packages/work-graph"
+    "packages/work-graph",
+    "examples/hyperspace-demo"
   ],
   "scripts": {
     "test": "npm run test:standard && npm --prefix packages/identity test && npm --prefix packages/agentsam-brand test && npm run test:connectors && npm run test:providers",
     "test:brand": "npm --prefix packages/agentsam-brand test",
+    "brand:scan": "python3 scripts/brand-compliance/brand_compliance.py scan",
+    "brand:check": "python3 scripts/brand-compliance/brand_compliance.py check",
+    "brand:apply": "python3 scripts/brand-compliance/brand_compliance.py apply",
     "test:content": "npm run build -w @inneranimalmedia/agentsam-assets-core && npm run test -w @inneranimalmedia/agentsam-assets-core && npm run build -w @inneranimalmedia/agentsam-scoring && npm run test -w @inneranimalmedia/agentsam-scoring && npm run build -w @inneranimalmedia/agentsam-cloudflare-images && npm run test -w @inneranimalmedia/agentsam-cloudflare-images && npm run build -w @inneranimalmedia/agentsam-content && npm run test -w @inneranimalmedia/agentsam-content && npm run build -w @inneranimalmedia/agentsam-content-studio && npm run test -w @inneranimalmedia/agentsam-content-studio",
     "build:content": "npm run build -w @inneranimalmedia/agentsam-assets-core && npm run build -w @inneranimalmedia/agentsam-scoring && npm run build -w @inneranimalmedia/agentsam-cloudflare-images && npm run build -w @inneranimalmedia/agentsam-content && npm run build -w @inneranimalmedia/agentsam-content-studio",
     "test:standard": "node test/smoke.mjs && npm run test:unit && npm run test:cli && npm run test:integration:mock && npm run test:terminal:mock",
@@ -271,7 +301,7 @@
     "test:terminal:mock": "node --test test/terminal/*.test.mjs",
     "test:live:terminal": "node --test test/live/*.live.test.mjs",
     "test:identity": "npm --prefix packages/identity test",
-    "test:workspaces": "npm --prefix packages/agentsam-contracts test && npm --prefix packages/agentsam-contracts run typecheck && npm --prefix packages/agentsam-errors test && npm --prefix packages/agentsam-vault test && npm --prefix packages/agentsam-repository test && npm --prefix packages/agentsam-workbench test && npm --prefix packages/agentsam-workbench run typecheck && npm --prefix packages/agentsam-nav run typecheck && npm --prefix packages/agentsam-shell-kit run typecheck && npm --prefix packages/work-graph test && npm --prefix packages/agentsam-queue-control test && npm --prefix packages/cms-runtime test && npm --prefix packages/agentsam-goap test",
+    "test:workspaces": "npm --prefix packages/agentsam-contracts run build && npm --prefix packages/agentsam-contracts test && npm --prefix packages/agentsam-contracts run typecheck && npm --prefix packages/agentsam-errors test && npm --prefix packages/agentsam-vault test && npm --prefix packages/agentsam-repository test && npm --prefix packages/agentsam-workbench run build && npm --prefix packages/agentsam-workbench test && npm --prefix packages/agentsam-workbench run typecheck && npm --prefix packages/agentsam-nav run typecheck && npm --prefix packages/agentsam-shell-kit run typecheck && npm --prefix packages/work-graph test && npm --prefix packages/agentsam-queue-control test && npm --prefix packages/cms-runtime test && npm --prefix packages/agentsam-goap test && npm --prefix packages/agentsam-hooks test",
     "test:autorag": "npm --prefix packages/agentsam-knowledge test",
     "smoke": "node test/smoke.mjs",
     "verify:package": "node scripts/verify-package.mjs",
@@ -281,7 +311,7 @@
     "test:python": "node scripts/verify-python.mjs",
     "verify:release": "npm run verify && npm run verify:packages:public && npm run verify:knowledge-package && npm run test:python && npm run security:release",
     "pack:check": "node scripts/verify-pack.mjs",
-    "verify": "npm run release:train:check && npm run errors:check && npm run proto:check && npm test && npm run test:workspaces && npm run cad:registry:check && npm run app:validate && npm run verify:boundaries && npm run verify:package && npm run verify:bootstrap && npm run pack:check",
+    "verify": "npm run brand:check && npm run release:train:check && npm run errors:check && npm run proto:check && npm test && npm run test:workspaces && npm run cad:registry:check && npm run app:validate && npm run verify:boundaries && npm run verify:package && npm run verify:bootstrap && npm run pack:check",
     "publish:identity-alpha": "bash scripts/publish-identity-alpha.sh",
     "publish:identity-alpha:dry-run": "bash scripts/publish-identity-alpha.sh --dry-run",
     "publish:identity-alpha:publish-only": "bash scripts/publish-identity-alpha.sh --publish-only",
@@ -294,7 +324,7 @@
     "security:check": "node src/security/cli.mjs scan",
     "security:repair": "node src/security/cli.mjs repair",
     "ui:preview": "node scripts/ui-preview.mjs",
-    "test:connectors": "node --test packages/connectors/cloudflare/tests/**/*.test.mjs",
+    "test:connectors": "node --test packages/connectors/cfoa/tests/**/*.test.mjs",
     "verify:npm10-lock": "node apps/local-studio/scripts/verify-npm10-lock.mjs",
     "proto:generate": "node scripts/generate-proto.mjs",
     "proto:check": "node scripts/verify-proto.mjs",
@@ -316,7 +346,8 @@
     "release:train:check": "node scripts/release-train.mjs check",
     "release:train:align": "node scripts/release-train.mjs align",
     "ci:products": "node scripts/ci-products.mjs",
-    "verify:packages:public": "node scripts/verify-public-packages.mjs"
+    "verify:packages:public": "node scripts/verify-public-packages.mjs",
+    "test:hooks": "npm --prefix packages/agentsam-hooks test"
   },
   "engines": {
     "node": ">=22 <25",
@@ -325,7 +356,7 @@
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "@grpc/grpc-js": "^1.14.4",
-    "@inneranimalmedia/agentsam-errors": "2.6.9",
+    "@inneranimalmedia/agentsam-errors": "2.6.11",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "google-protobuf": "^3.21.4",
     "node-pty": "^1.1.0",
@@ -376,7 +407,7 @@
     "@electric-sql/pglite-pgvector": "0.0.9",
     "esbuild": "0.28.1",
     "grpc-tools": "^1.13.1",
-    "wrangler": "4.145.0"
+    "wrangler": "4.147.0"
   },
   "overrides": {
     "@types/react": "19.2.18",

package/packages/agentsam-brand/README.md

@@ -114,3 +114,6 @@ npm --prefix packages/theme-scenes test
 ```
 
 See `packages/theme-scenes/README.md`. Studio shell (Moon Glass → Brand Studio) sits above both packages in a later tranche.
+
+<!-- agentsam:trademark-notice -->
+> Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).

package/packages/agentsam-brand/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-brand",
-  "version": "2.6.9",
+  "version": "2.6.11",
   "description": "Deterministic Brand Intelligence + portable brand-asset promotion SDK for AgentSam (inspect, derive, plan, promote, publish, verify).",
   "type": "module",
   "license": "MIT",
@@ -12,7 +12,7 @@
   },
   "main": "./src/index.js",
   "bin": {
-    "agentsam-brand": "./bin/agentsam-brand.mjs"
+    "agentsam-brand": "bin/agentsam-brand.mjs"
   },
   "exports": {
     ".": "./src/index.js",

package/packages/agentsam-brand/src/core/v2/compile.js

@@ -35,7 +35,7 @@ function tokensToCss(tokens = {}) {
 }
 
 function tokensToJson(tokens = {}) {
-  return `${JSON.stringify({ $schema: 'https://agentsam.dev/schemas/brand-tokens/v1.json', ...tokens }, null, 2)}\n`;
+  return `${JSON.stringify({ $schema: 'https://agentsam.inneranimalmedia.com/schemas/brand-tokens/v1.json', ...tokens }, null, 2)}\n`;
 }
 
 function buildStudioHtml(pack) {

package/packages/agentsam-brand/src/core/v2/schema.js

@@ -6,7 +6,7 @@
  */
 
 export const BRAND_PACK_SCHEMA = 'agentsam.brand-pack.v2';
-export const BRAND_PACK_SCHEMA_URL = 'https://agentsam.dev/schemas/brand-pack/v2.json';
+export const BRAND_PACK_SCHEMA_URL = 'https://agentsam.inneranimalmedia.com/schemas/brand-pack/v2.json';
 export const BRAND_PACK_FILENAME = 'brand.pack.json';
 
 /** Empty brand graph — never seeds product identity. */

package/packages/agentsam-contracts/dist/adapter.d.ts

@@ -0,0 +1,22 @@
+import type { AgentEvent } from './events';
+import type { AgentInput, AgentRun } from './agent';
+import type { AgentCapability } from './tools';
+import type { ModelOption } from './models';
+export interface AgentWorkbenchAdapter {
+    send(input: AgentInput): AgentRun | Promise<AgentRun>;
+    cancel(runId: string): void | Promise<void>;
+    getModels(): ModelOption[] | Promise<ModelOption[]>;
+    getCapabilities(): AgentCapability[] | Promise<AgentCapability[]>;
+    subscribe(conversationId: string, onEvent: (event: AgentEvent) => void): () => void;
+}
+export interface BrowserWorkbenchAdapter {
+    navigate(url: string): void | Promise<void>;
+    back?(): void | Promise<void>;
+    forward?(): void | Promise<void>;
+    reload?(): void | Promise<void>;
+}
+export interface TerminalWorkbenchAdapter {
+    write(command: string): void | Promise<void>;
+    interrupt?(): void | Promise<void>;
+    resize?(cols: number, rows: number): void | Promise<void>;
+}

package/packages/agentsam-contracts/dist/agent.d.ts

@@ -0,0 +1,66 @@
+import type { AgentAttachment } from './artifacts';
+import type { AgentContext } from './context';
+export type AgentRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface AgentMessage {
+    id: string;
+    role: AgentRole;
+    content: string;
+    createdAt: number;
+    name?: string;
+    modelId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentInput {
+    conversationId: string;
+    text: string;
+    attachments?: AgentAttachment[];
+    context?: AgentContext;
+    modelId?: string;
+    capabilityIds?: string[];
+}
+export type AgentRunMode = 'ask' | 'plan' | 'agent' | 'debug' | 'multitask';
+export type AgentRunSelectedBy = 'manual' | 'automatic' | 'fallback';
+export type AgentRunStatus = 'queued' | 'running' | 'paused' | 'waiting_external' | 'waiting_child' | 'awaiting_input' | 'awaiting_approval' | 'sleeping' | 'retry_scheduled' | 'partial' | 'completed' | 'cancelled' | 'failed' | 'timed_out';
+export type AgentRunTerminalStatus = 'completed' | 'cancelled' | 'failed' | 'timed_out';
+export type AgentRunWaitingStatus = 'waiting_external' | 'waiting_child' | 'awaiting_input' | 'awaiting_approval' | 'sleeping' | 'retry_scheduled';
+export interface AgentRun {
+    id: string;
+    conversationId?: string;
+    status: AgentRunStatus;
+    startedAt?: number;
+    completedAt?: number;
+    accountId?: string;
+    kind?: string;
+    externalAgentId?: string;
+    externalRunId?: string;
+    parentRunId?: string;
+    sourceClient?: string;
+    surface?: string;
+    mode?: AgentRunMode;
+    modelId?: string;
+    modelKey?: string;
+    reasoningEffort?: string;
+    requestedServiceTier?: string;
+    actualServiceTier?: string;
+    selectedBy?: AgentRunSelectedBy;
+    cancelRequested?: boolean;
+    errorCode?: string;
+    errorMessage?: string;
+    error?: string;
+    modelCallCount?: number;
+    toolCallCount?: number;
+    inputTokens?: number;
+    cachedInputTokens?: number;
+    outputTokens?: number;
+    reasoningTokens?: number;
+    costUsd?: number;
+    createdAt?: number;
+    updatedAt?: number;
+    latencyMs?: number;
+    planId?: string;
+    todoId?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare function isAgentRunTerminalStatus(status: AgentRunStatus): status is AgentRunTerminalStatus;
+export declare function isAgentRunWaitingStatus(status: AgentRunStatus): status is AgentRunWaitingStatus;
+export declare function isAgentRunModelActiveStatus(status: AgentRunStatus): boolean;

package/packages/agentsam-contracts/dist/agent.js

@@ -0,0 +1,15 @@
+// src/agent.ts
+function isAgentRunTerminalStatus(status) {
+  return status === "completed" || status === "cancelled" || status === "failed" || status === "timed_out";
+}
+function isAgentRunWaitingStatus(status) {
+  return status === "waiting_external" || status === "waiting_child" || status === "awaiting_input" || status === "awaiting_approval" || status === "sleeping" || status === "retry_scheduled";
+}
+function isAgentRunModelActiveStatus(status) {
+  return status === "queued" || status === "running";
+}
+export {
+  isAgentRunModelActiveStatus,
+  isAgentRunTerminalStatus,
+  isAgentRunWaitingStatus
+};

package/packages/agentsam-contracts/dist/artifacts.d.ts

@@ -0,0 +1,70 @@
+export type AgentArtifactKind = 'code' | 'file' | 'preview' | 'browser' | 'terminal' | 'deploy' | 'render' | 'model' | 'receipt' | string;
+export interface AgentAttachment {
+    id: string;
+    /** @deprecated prefer kind — kept for backward compatibility */
+    name: string;
+    mimeType?: string;
+    size?: number;
+    /** @deprecated text-file shortcut — do not use for images */
+    text?: string;
+    url?: string;
+    metadata?: Record<string, unknown>;
+    /** Structured multimodal fields (v1+) */
+    kind?: 'image' | 'document' | 'text' | 'archive' | 'audio' | 'video' | 'model' | 'binary';
+    source?: {
+        type: 'local_path';
+        path: string;
+    } | {
+        type: 'blob';
+        blobId: string;
+    } | {
+        type: 'url';
+        url: string;
+    } | {
+        type: 'r2';
+        bucket: string;
+        key: string;
+    } | {
+        type: 'artifact';
+        artifactId: string;
+    };
+    sha256?: string;
+    image?: {
+        width: number;
+        height: number;
+        alpha?: boolean;
+        orientation?: number;
+    };
+    preview?: {
+        url?: string;
+        localPath?: string;
+    };
+    inference?: {
+        mimeType: string;
+        source: {
+            type: 'local_path';
+            path: string;
+        } | {
+            type: 'blob';
+            blobId: string;
+        } | {
+            type: 'url';
+            url: string;
+        };
+        width?: number;
+        height?: number;
+        bytes?: number;
+    };
+    lifetime?: 'ephemeral' | 'conversation' | 'project' | 'artifact' | 'brand';
+}
+export interface AgentArtifact {
+    id: string;
+    kind: AgentArtifactKind;
+    title?: string;
+    mimeType?: string;
+    content?: string;
+    url?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    metadata?: Record<string, unknown>;
+}

package/packages/agentsam-contracts/dist/authority.d.ts

@@ -0,0 +1,21 @@
+export type AgentAuthorityType = 'none' | 'host' | 'binding' | 'secret' | 'oauth' | 'connection';
+export interface AgentAuthorityRequirement {
+    type: AgentAuthorityType;
+    ref?: string;
+    provider?: string;
+    scopes?: string[];
+    optional?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Opaque, non-secret reference to authority resolved by the host runtime.
+ * Raw credentials/tokens must not be serialized into portable AgentSam contracts.
+ */
+export interface AgentResolvedAuthorityReference {
+    type: Exclude<AgentAuthorityType, 'none'>;
+    ref: string;
+    provider?: string;
+    accountRef?: string;
+    scopes?: string[];
+    metadata?: Record<string, unknown>;
+}

package/packages/agentsam-contracts/dist/context.d.ts

@@ -0,0 +1,14 @@
+export type AgentSurface = 'chat' | 'work' | 'cad' | 'cms' | string;
+export interface AgentContext {
+    surface: AgentSurface;
+    accountId?: string;
+    authUserId?: string;
+    repository?: string;
+    files?: string[];
+    selection?: unknown;
+    projectId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentContextProvider {
+    getContext(): AgentContext | Promise<AgentContext>;
+}