elanous 0.2.42 → 0.2.43

package/graphs/overlays/examples/research-runtime-empty-terminal.yaml

@@ -0,0 +1,28 @@
+overlay_id: research-runtime-empty-terminal
+target: research-loop
+stage: runtime
+applies_when: attempts >= 1
+patch:
+  - op: add
+    path: /nodes/-
+    value:
+      node_id: source-audit
+      kind: judge
+      recipe: observe-only
+      max_visits: 1
+      contract:
+        inputs: [worktree]
+        tools: read-only
+        outputs: [findings]
+  - op: add
+    path: /edges/-
+    value:
+      from: judge
+      on: outcome
+      map:
+        source-missing: source-audit
+  - op: add
+    path: /edges/-
+    value:
+      from: source-audit
+      to: merge

package/graphs/profiles/local.yaml

@@ -0,0 +1,5 @@
+profile_id: local
+applies_when: substrate == local
+state:
+  substrate: local
+overlays: []

package/graphs/profiles/pod.yaml

@@ -0,0 +1,4 @@
+profile_id: pod
+applies_when: substrate == pod
+state: { substrate: pod }
+overlays: []

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elanous",
   "mcpName": "io.github.ElanvitalAI/elanous",
-  "version": "0.2.42",
+  "version": "0.2.43",
   "description": "Self-healing coding harness where eyes, hands, and memory all turn on one sentence — it authors its own goals, implements them in isolated worktrees, and reviews its own work.",
   "license": "Apache-2.0",
   "author": "Elanvital AI",
@@ -60,6 +60,7 @@
     "prepack": "bun -e \"import { writePackagedRevision } from './src/version/code-revision.ts'; writePackagedRevision()\"",
     "postpack": "bun -e \"import { rmSync } from 'node:fs'; rmSync('src/version/packed-revision.json', { force: true })\"",
     "dev": "bun run src/index.ts",
+    "catalog:build": "bun run scripts/build-signed-catalog.ts",
     "build": "bun build src/index.ts --outdir dist --target bun",
     "sync": "bun run src/index.ts sync",
     "status": "bun run src/index.ts status",
@@ -104,6 +105,7 @@
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "diff": "^9.0.0",
+    "google-auth-library": "^10.6.2",
     "libsodium-wrappers": "^0.8.4",
     "mammoth": "^1.12.0",
     "mermaidtui": "^0.0.5",
@@ -125,9 +127,11 @@
     "yaml": "^2.8.3"
   },
   "optionalDependencies": {
-    "node-pty": "^1.1.0",
     "telegram": "^2.26.22"
   },
+  "elanousOptionalIntegrations": {
+    "node-pty": "^1.1.0"
+  },
   "devDependencies": {
     "@copilotkit/aimock": "1.45.1",
     "@types/bun": "^1.2.0",

package/plugins/demo-absorption-briefing/plugin.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "demo-absorption-briefing",
+  "version": "0.1.0",
+  "description": "Absorption briefing scene package: topic subscriptions, scheduled runs, issue briefs, and reopen follow-up.",
+  "extensions": {
+    "ai.elanous": {
+      "connectors": [
+        { "id": "exa", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "EXA_API_KEY" }] },
+        { "id": "firecrawl", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "FIRECRAWL_API_KEY" }] },
+        { "id": "xai", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "XAI_API_KEY" }] },
+        { "id": "telegram", "required": false, "fields": [{ "name": "botToken", "secret": true, "env": "ELANOUS_TELEGRAM_BOT_TOKEN" }] },
+        { "id": "telegram-chat", "required": false, "fields": [{ "name": "chatId", "secret": false, "env": "ELANOUS_TELEGRAM_CHAT_ID" }] },
+        { "id": "linear", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "LINEAR_API_KEY" }] }
+      ]
+    }
+  }
+}

package/plugins/demo-absorption-briefing/skills/demo-absorption-briefing/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: demo-absorption-briefing
+description: Subscribe an issue to the existing scheduled topic-briefing flow and report its status.
+---
+
+# Absorption briefing
+
+Use the existing `eln intake source` commands to inspect, add, and run topic sources. Keep scheduled execution and issue delivery on the existing intake pipeline. Report the source id and delivery result; do not invent findings when search providers are unavailable.

package/plugins/demo-browser-hand/plugin.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "demo-browser-hand",
+  "version": "0.1.0",
+  "description": "Browser hand scene package: navigation, capture, bypass guidance, and human interaction handoff.",
+  "extensions": {
+    "ai.elanous": {
+      "connectors": [
+        { "id": "linear", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "LINEAR_API_KEY" }] }
+      ]
+    }
+  }
+}

package/plugins/demo-browser-hand/skills/demo-browser-hand/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: demo-browser-hand
+description: Navigate and inspect web pages with the existing browser tools, handing off when a person must act.
+---
+
+# Browser hand
+
+Use the existing `BrowserOpen`, `BrowserNavigate`, `BrowserRead`, `BrowserScreenshot`, and `BrowserClose` tools. Ask the user to complete authentication, consent, or other human-only steps in the browser when required. Do not claim a page changed unless a fresh read confirms it.

package/plugins/demo-linear-secretary/plugin.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "demo-linear-secretary",
+  "version": "0.1.0",
+  "description": "Linear secretary scene package: issue creation, sub-issues, comments, checklists, and progress sync.",
+  "extensions": {
+    "ai.elanous": {
+      "connectors": [
+        { "id": "linear", "required": true, "fields": [{ "name": "apiKey", "secret": true, "env": "LINEAR_API_KEY" }] },
+        { "id": "telegram", "required": false, "fields": [{ "name": "botToken", "secret": true, "env": "ELANOUS_TELEGRAM_BOT_TOKEN" }] },
+        { "id": "telegram-chat", "required": false, "fields": [{ "name": "chatId", "secret": false, "env": "ELANOUS_TELEGRAM_CHAT_ID" }] }
+      ]
+    }
+  }
+}

package/plugins/demo-linear-secretary/skills/demo-linear-secretary/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: demo-linear-secretary
+description: Create and maintain Linear issues through the existing Elanous Linear secretary tool.
+---
+
+# Linear secretary
+
+Use the existing `elanous_linear_secretary` tool for issue creation, child issues, comments, checklists, and progress synchronization. Confirm the selected Linear project before creating issues. Never put API keys in issue text, comments, or tool arguments other than the configured connector.

package/plugins/demo-plugin-wizard/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "demo-plugin-wizard",
+  "version": "0.1.0",
+  "description": "Plugin wizard scene package: search a marketplace, install packages, develop with Claude or Codex, and use the result.",
+  "extensions": {
+    "ai.elanous": {
+      "connectors": []
+    }
+  }
+}

package/plugins/demo-plugin-wizard/skills/demo-plugin-wizard/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: demo-plugin-wizard
+description: Search, install, and use plugins with existing Elanous plugin commands.
+---
+
+# Plugin wizard
+
+Use `eln plugin market` to inspect configured marketplaces, `eln plugin add` to install a package, and `eln plugin make` to create a local graph plugin. Keep marketplace trust and capability consent visible; report the exact plugin id and version after installation. Claude Code and GitHub CLI authentication use their existing login flows, not API-key prompts.

package/plugins/demo-research/plugin.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "demo-research",
+  "version": "0.1.0",
+  "description": "Research scene package: Exa and Firecrawl search, Grok coverage, research turn guidance, and Bloom defaults.",
+  "extensions": {
+    "ai.elanous": {
+      "connectors": [
+        { "id": "exa", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "EXA_API_KEY" }] },
+        { "id": "firecrawl", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "FIRECRAWL_API_KEY" }] },
+        { "id": "xai", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "XAI_API_KEY" }] },
+        { "id": "tavily", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "TAVILY_API_KEY" }] }
+      ]
+    }
+  }
+}

package/plugins/demo-research/skills/demo-research/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: demo-research
+description: Research a question using the existing Elanous research command and available search providers.
+---
+
+# Research
+
+Use the existing `eln research` command or built-in research tools. Let the command select the configured providers, cite source URLs, and keep unverified claims marked as unknown. Exa, Firecrawl, Grok, and Tavily are optional connectors; a missing provider must not be described as a broken install.

package/plugins/demo-video-briefing/plugin.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://antigravity.google/schemas/v1/plugin.json",
+  "name": "demo-video-briefing",
+  "version": "0.1.0",
+  "description": "Video briefing scene package: turn a decision memo into a short video and deliver it.",
+  "extensions": {
+    "ai.elanous": {
+      "connectors": [
+        { "id": "elevenlabs", "required": false, "fields": [{ "name": "apiKey", "secret": true, "env": "ELEVENLABS_API_KEY" }] },
+        { "id": "telegram", "required": false, "fields": [{ "name": "botToken", "secret": true, "env": "ELANOUS_TELEGRAM_BOT_TOKEN" }] },
+        { "id": "telegram-chat", "required": false, "fields": [{ "name": "chatId", "secret": false, "env": "ELANOUS_TELEGRAM_CHAT_ID" }] }
+      ]
+    }
+  }
+}

package/plugins/demo-video-briefing/skills/demo-video-briefing/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: demo-video-briefing
+description: Turn a decision memo into a short video with the existing Elanous explainer-video engine.
+---
+
+# Video briefing
+
+Use the existing explainer-video skill and engine to draft, render, and inspect the short briefing. The local renderer works without an external video key. ElevenLabs and Telegram are optional connectors; do not report delivery unless the existing sender confirms it.

package/scripts/build-signed-catalog.ts

@@ -0,0 +1,48 @@
+import { mkdtempSync, readFileSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { signCatalogPayload, type SignedCatalogPayload } from '../src/registry/catalog-server.js';
+import { getElanousConfigDirOverride, resetElanousConfigDir, setElanousConfigDir } from '../src/elanous-config-dir.js';
+
+function option(name: string): string | undefined {
+  const index = process.argv.indexOf(name);
+  return index >= 0 ? process.argv[index + 1] : undefined;
+}
+
+const keyPath = option('--key-file') ?? process.env.ELANOUS_CATALOG_SIGNING_KEY_FILE;
+if (!keyPath) throw new Error('Pass --key-file or ELANOUS_CATALOG_SIGNING_KEY_FILE (private key is read only and never printed).');
+const root = mkdtempSync(join(tmpdir(), 'elanous-catalog-build-'));
+const envKeys = ['NODE_ENV', 'ELANOUS_STATE_DIR', 'ELANOUS_CATALOG_SERVER_CACHE', 'ELANOUS_CATALOG_PUBLIC_KEY_FILE', 'ELANOUS_CATALOG_DISCOVERY_SNAPSHOT'];
+const previousEnv = new Map(envKeys.map((key) => [key, process.env[key]]));
+const previousConfigDir = getElanousConfigDirOverride();
+for (const key of envKeys) delete process.env[key];
+process.env.NODE_ENV = 'test';
+process.env.ELANOUS_STATE_DIR = root;
+setElanousConfigDir(root);
+try {
+  const { getCatalog } = await import('../src/registry/loader.js');
+  const versionDoc = parseYaml(readFileSync(resolve('catalog/meta/catalogVersion.yaml'), 'utf8')) as { catalogVersion?: unknown };
+  if (!Number.isSafeInteger(versionDoc.catalogVersion) || (versionDoc.catalogVersion as number) < 1) {
+    throw new Error('catalog/meta/catalogVersion.yaml must contain a positive integer catalogVersion.');
+  }
+  const catalog = getCatalog();
+  const payload: SignedCatalogPayload = {
+    catalogVersion: versionDoc.catalogVersion as number,
+    generatedAt: new Date().toISOString(),
+    providers: [...catalog.providers.values()].sort((a, b) => a.id.localeCompare(b.id)),
+    models: [...catalog.models.values()].sort((a, b) => a.id.localeCompare(b.id)),
+  };
+  const signed = signCatalogPayload(payload, readFileSync(resolve(keyPath)));
+  const outPath = resolve(option('--out') ?? 'dist/catalog/catalog.json');
+  mkdirSync(dirname(outPath), { recursive: true });
+  writeFileSync(outPath, `${JSON.stringify(signed, null, 2)}\n`, { encoding: 'utf8', mode: 0o644 });
+  console.log(`Wrote signed catalog v${payload.catalogVersion}: ${outPath}`);
+} finally {
+  resetElanousConfigDir();
+  if (previousConfigDir) setElanousConfigDir(previousConfigDir);
+  for (const [key, value] of previousEnv) {
+    if (value === undefined) delete process.env[key]; else process.env[key] = value;
+  }
+  rmSync(root, { recursive: true, force: true });
+}

package/scripts/ci-typecheck-main-delta.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# Pinned landing TSC guard: compare the integrated commit against its exact main baseline.
+set -euo pipefail
+
+BASE_SHA=${1:-}
+if [[ ! "$BASE_SHA" =~ ^[0-9a-fA-F]{40}$ ]]; then
+  echo "error: expected a pinned 40-character main baseline SHA" >&2
+  exit 2
+fi
+
+ROOT=$(git rev-parse --show-toplevel 2>/dev/null) || { echo "error: repository root unavailable" >&2; exit 2; }
+git -C "$ROOT" cat-file -e "${BASE_SHA}^{commit}" 2>/dev/null || { echo "error: main baseline commit unavailable: $BASE_SHA" >&2; exit 2; }
+# Share dependencies for speed only when resolution inputs match. If they differ,
+# install the pinned main baseline from its own lockfile in the detached worktree.
+dependency_changes=$(git -C "$ROOT" diff --name-only "$BASE_SHA" HEAD) || { echo "error: dependency diff unavailable" >&2; exit 2; }
+dependency_changes=$(printf '%s\n' "$dependency_changes" | awk '/(^|\/)(package\.json|bun\.lock(\.b)?|package-lock\.json|npm-shrinkwrap\.json|pnpm-lock\.yaml|yarn\.lock|bunfig\.toml)$/')
+INSTALL_BASELINE=0
+if [[ -n "$dependency_changes" ]]; then
+  printf '[tsc-main-delta] dependency inputs changed; installing pinned-main dependencies independently:\n%s\n' "$dependency_changes"
+  INSTALL_BASELINE=1
+fi
+TMP=$(mktemp -d "${TMPDIR:-/var/tmp}/elanous-tsc-delta.XXXXXXXX") || { echo "error: temporary directory unavailable" >&2; exit 2; }
+BASE_TREE="$TMP/base"
+
+cleanup() {
+  git -C "$ROOT" worktree remove --force "$BASE_TREE" >/dev/null 2>&1 || true
+  rm -rf "$TMP"
+}
+trap cleanup EXIT
+trap 'exit 130' INT TERM
+
+git -C "$ROOT" worktree add --quiet --detach "$BASE_TREE" "$BASE_SHA" || { echo "error: main baseline worktree unavailable" >&2; exit 2; }
+if [[ "$INSTALL_BASELINE" == 1 ]]; then
+  (cd "$BASE_TREE" && bun install --frozen-lockfile) || { echo "error: pinned-main dependency install failed" >&2; exit 2; }
+else
+  ln -s "$ROOT/node_modules" "$BASE_TREE/node_modules" || { echo "error: baseline dependency link unavailable" >&2; exit 2; }
+fi
+
+run_tsc() {
+  local tree="$1" label="$2" rc
+  local log="$TMP/$label.log" diagnostics="$TMP/$label.diagnostics"
+  if (cd "$tree" && NODE_OPTIONS='--max-old-space-size=12288' bunx tsc --noEmit --pretty false) >"$log" 2>&1; then rc=0; else rc=$?; fi
+  if [[ "$rc" != 0 && "$rc" != 1 && "$rc" != 2 ]]; then
+    cat "$log" >&2
+    echo "error: $label tsc did not complete (rc=$rc)" >&2
+    return 2
+  fi
+  awk '
+    function flush() {
+      if (active) {
+        # Keep path/code/full text as the key; only ignore line/column drift. A moved
+        # diagnostic is intentionally treated as new so cross-file errors stay visible.
+        sub(/\([0-9]+,[0-9]+\): error TS/, ": error TS", block)
+        print block
+      }
+      active = 0; block = ""
+    }
+    /^[^[:space:]].*: error TS[0-9]+:/ { flush(); block = $0; active = 1; next }
+    active && /^[[:space:]]+/ { sub(/^[[:space:]]+/, ""); block = block " | " $0; next }
+    { flush() }
+    END { flush() }
+  ' "$log" >"$TMP/$label.raw-diagnostics"
+  LC_ALL=C sort "$TMP/$label.raw-diagnostics" >"$diagnostics"
+  if [[ "$rc" != 0 && ! -s "$diagnostics" ]]; then
+    cat "$log" >&2
+    echo "error: $label tsc failed without parseable TypeScript diagnostics (rc=$rc)" >&2
+    return 2
+  fi
+  if [[ "$rc" == 0 && -s "$diagnostics" ]]; then
+    cat "$log" >&2
+    echo "error: $label tsc returned success with diagnostics" >&2
+    return 2
+  fi
+  printf '%s\n' "$rc"
+}
+
+BASE_RC=$(run_tsc "$BASE_TREE" baseline) || exit $?
+HEAD_RC=$(run_tsc "$ROOT" integration) || exit $?
+LC_ALL=C comm -13 "$TMP/baseline.diagnostics" "$TMP/integration.diagnostics" >"$TMP/new.diagnostics"
+new_count=$(wc -l <"$TMP/new.diagnostics" | tr -d ' ')
+printf '[tsc-main-delta] base=%s base_rc=%s head=%s head_rc=%s baseline_errors=%s head_errors=%s new_errors=%s\n' \
+  "$BASE_SHA" "$BASE_RC" "$(git -C "$ROOT" rev-parse HEAD)" "$HEAD_RC" \
+  "$(wc -l <"$TMP/baseline.diagnostics" | tr -d ' ')" "$(wc -l <"$TMP/integration.diagnostics" | tr -d ' ')" "$new_count"
+if [[ "$new_count" != 0 ]]; then
+  echo "error: main-baseline tsc introduced $new_count TypeScript diagnostic(s)" >&2
+  cat "$TMP/new.diagnostics" >&2
+  exit 1
+fi

package/scripts/codex-fallback-live-probe.ts

@@ -55,7 +55,7 @@ export type LiveProbeInputs = {
 
 export type LiveProbeLine = LiveProbeInputs & (
   | { readonly action: 'stay'; readonly why: StayReason; readonly backend?: never; readonly to?: never }
-  | { readonly action: 'switch-backend'; readonly backend: 'grok' | 'claude' | 'openrouter'; readonly model?: string; readonly why?: never; readonly to?: never }
+  | { readonly action: 'switch-backend'; readonly backend: 'grok' | 'claude' | 'openrouter' | 'zai'; readonly model?: string; readonly why?: never; readonly to?: never }
   | { readonly action: 'codex-rotate'; readonly to: string; readonly why?: never; readonly backend?: never }
   | { readonly action: 'codex-credits'; readonly to?: string; readonly why?: never; readonly backend?: never }
 ) & { readonly inputKind: 'live' };