@inneranimalmedia/agentsam-sdk 2.6.7 → 2.6.8

package/native/agentsam-machine/core/contracts/source-types.v1.json

@@ -0,0 +1,353 @@
+{
+  "schema": "agentsam.source-types.v1",
+  "types": [
+    {
+      "id": "javascript",
+      "label": "JavaScript",
+      "kind": "code",
+      "extensions": [
+        ".js",
+        ".mjs",
+        ".cjs",
+        ".jsx"
+      ],
+      "knowledge": true,
+      "ast": true,
+      "syntax_by_extension": {
+        ".jsx": "jsx"
+      }
+    },
+    {
+      "id": "typescript",
+      "label": "TypeScript",
+      "kind": "code",
+      "extensions": [
+        ".ts",
+        ".tsx",
+        ".mts",
+        ".cts"
+      ],
+      "knowledge": true,
+      "ast": true,
+      "syntax_by_extension": {
+        ".tsx": "tsx"
+      }
+    },
+    {
+      "id": "rust",
+      "label": "Rust",
+      "kind": "code",
+      "extensions": [
+        ".rs"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "python",
+      "label": "Python",
+      "kind": "code",
+      "extensions": [
+        ".py"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "go",
+      "label": "Go",
+      "kind": "code",
+      "extensions": [
+        ".go"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "java",
+      "label": "Java",
+      "kind": "code",
+      "extensions": [
+        ".java"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "shell",
+      "label": "Shell",
+      "kind": "code",
+      "extensions": [
+        ".sh",
+        ".bash",
+        ".zsh"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "yaml",
+      "label": "YAML",
+      "kind": "code",
+      "extensions": [
+        ".yaml",
+        ".yml"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "toml",
+      "label": "TOML",
+      "kind": "code",
+      "extensions": [
+        ".toml"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "vue",
+      "label": "Vue",
+      "kind": "code",
+      "extensions": [
+        ".vue"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "svelte",
+      "label": "Svelte",
+      "kind": "code",
+      "extensions": [
+        ".svelte"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "markdown",
+      "label": "Markdown",
+      "kind": "document",
+      "extensions": [
+        ".md",
+        ".mdx"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "json",
+      "label": "JSON",
+      "kind": "document",
+      "extensions": [
+        ".json"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "jsonc",
+      "label": "JSONC",
+      "kind": "document",
+      "extensions": [
+        ".jsonc"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "html",
+      "label": "HTML",
+      "kind": "document",
+      "extensions": [
+        ".html",
+        ".htm"
+      ],
+      "knowledge": true,
+      "ast": false,
+      "frontend": true
+    },
+    {
+      "id": "css",
+      "label": "CSS",
+      "kind": "document",
+      "extensions": [
+        ".css",
+        ".scss",
+        ".sass"
+      ],
+      "knowledge": true,
+      "ast": false,
+      "frontend": true
+    },
+    {
+      "id": "svg",
+      "label": "SVG",
+      "kind": "asset",
+      "extensions": [
+        ".svg"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "png",
+      "label": "PNG",
+      "kind": "asset",
+      "extensions": [
+        ".png"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "jpeg",
+      "label": "JPEG",
+      "kind": "asset",
+      "extensions": [
+        ".jpg",
+        ".jpeg"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "webp",
+      "label": "WebP",
+      "kind": "asset",
+      "extensions": [
+        ".webp"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "gif",
+      "label": "GIF",
+      "kind": "asset",
+      "extensions": [
+        ".gif"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "text",
+      "label": "Text",
+      "kind": "document",
+      "extensions": [
+        ".txt"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "xml",
+      "label": "XML",
+      "kind": "document",
+      "extensions": [
+        ".xml"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "csv",
+      "label": "CSV",
+      "kind": "document",
+      "extensions": [
+        ".csv"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "sql",
+      "label": "SQL",
+      "kind": "code",
+      "extensions": [
+        ".sql"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "wasm",
+      "label": "WebAssembly",
+      "kind": "binary",
+      "extensions": [
+        ".wasm"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "liquid",
+      "label": "Liquid",
+      "kind": "document",
+      "extensions": [
+        ".liquid"
+      ],
+      "knowledge": true,
+      "ast": false,
+      "frontend": true
+    },
+    {
+      "id": "woff",
+      "label": "WOFF Font",
+      "kind": "asset",
+      "extensions": [
+        ".woff",
+        ".woff2"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "ttf",
+      "label": "TrueType Font",
+      "kind": "asset",
+      "extensions": [
+        ".ttf",
+        ".otf"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "mp4",
+      "label": "MP4 Video",
+      "kind": "asset",
+      "extensions": [
+        ".mp4",
+        ".webm",
+        ".mov"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "ico",
+      "label": "Icon",
+      "kind": "asset",
+      "extensions": [
+        ".ico"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "glb",
+      "label": "glTF Binary",
+      "kind": "asset",
+      "extensions": [
+        ".glb",
+        ".gltf"
+      ],
+      "knowledge": false,
+      "ast": false
+    }
+  ]
+}

package/native/agentsam-machine/core/src/lib.rs

@@ -31,6 +31,8 @@ const IGNORE_DIRS: &[&str] = &[
     ".git",
     ".agentsam",
     "node_modules",
+    "python_modules",
+    "vendor",
     "target",
     "build",
     "dist",
@@ -694,10 +696,14 @@ fn is_ignored_directory(name: &str) -> bool {
 }
 
 fn is_noise_file(name: &str) -> bool {
+    let lower = name.to_ascii_lowercase();
     name == ".DS_Store"
         || name == "Thumbs.db"
         || name == "desktop.ini"
         || name.starts_with("._")
+        || lower.ends_with(".min.js")
+        || lower.ends_with(".bundle.js")
+        || lower.ends_with(".map")
 }
 
 fn relative_path(root: &Path, path: &Path) -> String {

package/native/agentsam-machine/core/src/source_types.rs

@@ -1,9 +1,9 @@
-//! Shared source-type taxonomy loaded from contracts/source-types.v1.json.
+//! Shared source-type taxonomy loaded from the crate-vendored source-types contract.
 use serde::Deserialize;
 use std::collections::HashMap;
 use std::sync::OnceLock;
 
-const SOURCE_TYPES_JSON: &str = include_str!("../../../../contracts/source-types.v1.json");
+const SOURCE_TYPES_JSON: &str = include_str!("../contracts/source-types.v1.json");
 
 #[derive(Debug, Clone, Deserialize)]
 pub struct SourceTypeDef {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-sdk",
-  "version": "2.6.7",
+  "version": "2.6.8",
   "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",
@@ -118,7 +118,8 @@
     "./theme/forge": "./packages/theme-handyman-site/src/index.js",
     "./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/inventory": "./src/models/inventory-core.js",
+    "./goap": "./packages/agentsam-goap/src/index.js"
   },
   "bin": {
     "agentsam": "bin/agentsam",
@@ -144,17 +145,23 @@
     "packages/agentsam-nav/dist",
     "packages/work-graph",
     "packages/agentsam-queue-control",
+    "packages/agentsam-goap",
     "packages/connectors/cloudflare",
     "packages/providers/completeful",
     "templates",
     "docs",
     "examples",
-    "test",
     "python",
     "protocol",
     "contracts",
     "migrations",
-    "skills",
+    "skills/README.md",
+    "skills/catalog.json",
+    "skills/agentsam-app-fundamentals",
+    "skills/agentsam-cloudflare-workers",
+    "skills/agentsam-codebaseindex",
+    "skills/agentsam-jr-dev",
+    "skills/agentsam-progression-guard",
     "services/knowledge/package.json",
     "services/knowledge/package-lock.json",
     "services/cad/server.py",
@@ -218,6 +225,7 @@
     "packages/agentsam-desktop-shell",
     "packages/agentsam-docs-theme",
     "packages/agentsam-errors",
+    "packages/agentsam-goap",
     "packages/agentsam-ide",
     "packages/agentsam-key-manager",
     "packages/agentsam-knowledge",
@@ -257,7 +265,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-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",
+    "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-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/agentsam-goap test",
     "test:autorag": "npm --prefix packages/agentsam-knowledge test",
     "smoke": "node test/smoke.mjs",
     "verify:package": "node scripts/verify-package.mjs",
@@ -306,6 +314,7 @@
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "@grpc/grpc-js": "^1.14.4",
+    "@inneranimalmedia/agentsam-errors": "2.6.8",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "google-protobuf": "^3.21.4",
     "node-pty": "^1.1.0",
@@ -361,7 +370,8 @@
   "overrides": {
     "@types/react": "19.2.18",
     "@types/react-dom": "19.2.3",
-    "esbuild": "0.28.1"
+    "esbuild": "0.28.1",
+    "dompurify": "3.4.16"
   },
   "packageManager": "npm@10.9.2"
 }

package/packages/agentsam-errors/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-errors",
-  "version": "2.6.7",
+  "version": "2.6.8",
   "description": "Canonical AgentSam runtime error normalization, classification, transport, remediation and rendering.",
   "type": "module",
   "main": "./src/index.js",

package/packages/agentsam-errors/src/index.js

@@ -1,6 +1,7 @@
 export * from './vocabulary.js';
 export * from './envelope.js';
 export * from './error.js';
+export * from './tool.js';
 export * from './normalize.js';
 export * from './redaction.js';
 export * from './fingerprint.js';

package/packages/agentsam-errors/src/tool.js

@@ -0,0 +1,56 @@
+import { createErrorEnvelope } from './envelope.js';
+import { AgentSamError } from './error.js';
+
+function clean(value) {
+  return value == null ? '' : String(value).trim();
+}
+
+function nativeFromCause(cause) {
+  if (!cause || typeof cause !== 'object') return null;
+  return {
+    code: cause.code || null,
+    exception_type: cause.name || null,
+    exit_code: cause.exit_code ?? cause.exitCode ?? null,
+    signal: cause.signal || null,
+    stderr: cause.stderr || null,
+    stdout: cause.stdout || null,
+    stack: cause.stack || null,
+  };
+}
+
+/**
+ * Build the canonical AgentSam error envelope for any tool/capability.
+ *
+ * Tool implementations should supply an existing ERROR_REASON plus tool/stage
+ * context. Do not mint tool-specific error taxonomies when the shared
+ * vocabulary already describes the failure.
+ */
+export function createToolErrorEnvelope(input = {}, options = {}) {
+  const tool = clean(input.tool);
+  if (!tool) throw new TypeError('tool is required');
+
+  const cause = options.cause || input.cause || null;
+  const { cause: _ignoredCause, ...envelopeInput } = input;
+
+  return createErrorEnvelope({
+    ...envelopeInput,
+    domain: input.domain || 'tool',
+    tool,
+    stage: clean(input.stage) || 'execute',
+    source: input.source || {
+      kind: 'agentsam',
+      name: 'agentsam-sdk',
+      service: tool,
+    },
+    native: input.native || nativeFromCause(cause),
+  });
+}
+
+/**
+ * Throwable view over createToolErrorEnvelope().
+ */
+export function createToolError(input = {}, options = {}) {
+  const cause = options.cause || input.cause || null;
+  const envelope = createToolErrorEnvelope(input, { cause });
+  return new AgentSamError(envelope, cause ? { cause } : {});
+}

package/packages/agentsam-errors/test/tool.test.mjs

@@ -0,0 +1,58 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {
+  AgentSamError,
+  ERROR_CODE,
+  ERROR_REASON,
+  createToolError,
+  createToolErrorEnvelope,
+  planRecovery,
+} from '../src/index.js';
+
+test('tool errors reuse the canonical AgentSam vocabulary', () => {
+  const error = createToolError({
+    reason: ERROR_REASON.STALE_VERSION,
+    message: 'The resource changed before this mutation could commit.',
+    tool: 'goap',
+    stage: 'activate_goal',
+    failure_class: 'conflict',
+    resource: { type: 'blackboard', id: 'bb_1' },
+    details: { expected_revision: 4, actual_revision: 5 },
+    operation: {
+      kind: 'mutation',
+      action: 'activate_goal',
+      resource_type: 'blackboard',
+      resource_id: 'bb_1',
+      read_only: false,
+      idempotent: true,
+      side_effect_state: 'confirmed_not_applied',
+    },
+  });
+
+  assert.equal(error instanceof AgentSamError, true);
+  assert.equal(error.code, ERROR_CODE.ABORTED);
+  assert.equal(error.reason, ERROR_REASON.STALE_VERSION);
+  assert.equal(error.envelope.domain, 'tool');
+  assert.equal(error.envelope.tool, 'goap');
+  assert.equal(error.envelope.retryable, true);
+  assert.equal(error.envelope.details.expected_revision, 4);
+
+  const recovery = planRecovery(error.envelope);
+  assert.equal(recovery.disposition, 'retry');
+  assert.equal(recovery.reason, 'optimistic_concurrency');
+});
+
+test('tool envelope preserves generic internal adapter classification', () => {
+  const envelope = createToolErrorEnvelope({
+    reason: ERROR_REASON.INTERNAL_ADAPTER_FAILED,
+    message: 'The storage adapter cannot provide the required atomic primitive.',
+    tool: 'queue-control',
+    stage: 'dispatch',
+    resource: { type: 'adapter', id: 'sqlite' },
+  });
+
+  assert.equal(envelope.code, ERROR_CODE.INTERNAL);
+  assert.equal(envelope.domain, 'tool');
+  assert.equal(envelope.tool, 'queue-control');
+  assert.equal(envelope.resolution_owner, 'agentsam');
+});

package/packages/agentsam-goap/README.md

@@ -0,0 +1,52 @@
+# @inneranimalmedia/agentsam-goap
+
+Portable GOAP control-plane contracts for AgentSam.
+
+This package does not define a second GOAP database. It maps stable logical ports onto tables AgentSam already owns.
+
+| Logical port | Existing authority |
+| --- | --- |
+| BlackboardStore | agentsam_workspace_state |
+| GoalStore | agentsam_tickets |
+| EventStore | agentsam_ticket_events |
+| PlanStore | agentsam_workflows, agentsam_workflow_nodes, agentsam_workflow_edges |
+| PlanRunStore | agentsam_workflow_runs |
+| ActionRunStore | agentsam_executions, agentsam_execution_steps |
+| ApprovalPort | agentsam_approval_queue |
+| QueuePort | @inneranimalmedia/agentsam-queue-control |
+| RuntimePort | agentsam.runtime.v1 / terminal runtime adapters |
+| EvidencePort | evidence snapshots and execution receipts |
+
+The core package imports no Wrangler, Cloudflare, SQLite, Postgres, Tauri, filesystem, or terminal implementation. Those are adapters.
+
+`projectGoapWorld()` is the deterministic perception seam: callers supply repository facts, the active project-local plan/TODO, knowledge freshness, and bounded evidence. It emits `agentsam.goap.world.v1` plus canonical blackboard, goal, and action contracts without performing storage, network, filesystem, or model work.
+
+## Frozen v1 contracts
+
+- agentsam.blackboard.v1
+- agentsam.goal.v1
+- agentsam.goap.action.v1
+- agentsam.goap.plan.v1
+- agentsam.goap.world.v1
+- agentsam.event.v1
+
+Database ticket statuses stay unchanged. The package maps them to logical goal states:
+
+- backlog -> proposed
+- active -> active
+- blocked -> blocked
+- in_review -> verifying
+- shipped -> satisfied
+- abandoned -> cancelled
+
+## Realtime and durability rule
+
+Blackboard mutation is compare-and-swap on a monotonically increasing revision. Events are append-only and expose opaque string cursors. The adapter owns the physical cursor prefix, so callers do not depend on SQLite/D1 rowid, Postgres sequences, or a future stream backend.
+
+Cross-store state changes must go through MutationPort. Goal activation updates blackboard revision, ticket status, and the activation event as one adapter-owned atomic operation. The D1/SQLite adapter therefore requires db.batch() for mutation operations.
+
+The Memory adapter is the conformance/reference adapter. The D1/SQLite adapter targets the common prepare/bind/first/all/run binding shape. Local SQLite supplies a transactional batch shim; Cloudflare D1 supplies batch natively.
+
+Portable ticket_events rows carry account_id and repository_id directly. The older platform host table does not. Set eventOwnership to ticket_join for that legacy shape; it scopes events through their owning ticket without requiring a second event table or a duplicate-column migration.
+
+Blackboard ownership is adapter-specific. Use blackboardOwnership=repository for account-owned portable/local stores. Shared hosts must verify repository ownership instead of trusting caller scope; IAM D1 uses blackboardOwnership=repository_join, which checks code_repositories.account_id on blackboard reads and CAS writes.

package/packages/agentsam-goap/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@inneranimalmedia/agentsam-goap",
+  "version": "2.6.8",
+  "description": "Portable AgentSam GOAP control-plane contracts and adapters over existing blackboard, ticket, workflow, execution, approval, queue, runtime, and evidence stores.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./contracts": "./src/contracts.js",
+    "./control-plane": "./src/control-plane.js",
+    "./adapters/memory": "./src/adapters/memory.js",
+    "./adapters/d1-sqlite": "./src/adapters/d1-sqlite.js",
+    "./world": "./src/world.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "@inneranimalmedia/agentsam-errors": "2.6.8"
+  },
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/agentsam-goap"
+  }
+}