@lazyingart/agintiflow 0.20.192 → 0.20.194

package/README.md

@@ -160,6 +160,7 @@ aginti --language de
 | Disable SCS for simple work | `/scs off` or `aginti --no-scs "task"` |
 | Control dynamic step budgets | `--dynamic-steps auto\|on\|off` |
 | Work with AAPS workflows | `aginti aaps status`, `/aaps validate` |
+| Coordinate sessions | `aginti agentlink status`, `/link peers`, `/link board default` |
 | Inspect or call MCP servers | `aginti mcp status`, `/mcp tools <server>`, `/mcp call <server> <tool> '{"arg":"value"}'` |
 | Choose models | `/route`, `/model`, `/spare`, `/wrapper`, `/auxiliary model` |
 | Switch permissions | `-s safe`, `-s normal`, `-s danger`, or `/safe`, `/normal`, `/danger` |
@@ -245,6 +246,7 @@ The website keeps the visual walkthrough in a carousel so this README can stay f
 | Image reading and web research | `read_image` uses OpenAI vision for workspace images when `OPENAI_API_KEY` is configured, otherwise it can fall back to Codex CLI image attachments when available. It saves JSON and Markdown reports and can surface the report in the canvas. `web_research` preserves source lists, and optional OpenAI hosted web search or `research_wrapper` can be used for higher-confidence research. |
 | SCS mode | Default Student-Committee-Supervisor quality gate with independent planning, execution, and validation roles. |
 | AAPS adapter | Optional `@lazyingart/aaps` integration for `.aaps` workflow init, validate, parse, compile, dry-run, and run commands. |
+| AgentLink | Local-first collaboration between AgInTi sessions through boards, typed messages, action contracts, safe summaries, and evidence bundles. |
 | Image generation | Optional GRS AI and Venice image tools with saved manifests and canvas artifact previews. |
 | Skill library | Built-in Markdown skills plus project-local `.aginti/skills/<id>/SKILL.md` skills for reusable workflow knowledge that should not be hard-coded into the runtime. |
 | External skill packs | Whole Agent Skills repositories can be loaded as grouped packs without flattening. A sibling `../scientific-agent-skills` checkout is discovered as the `scientific` category, so commands like `aginti skills rdkit` and `aginti skills "single cell scanpy"` expose K-Dense Scientific Agent Skills when present. |
@@ -391,6 +393,7 @@ More detail:
 | Topic | Link |
 | --- | --- |
 | AAPS adapter | [docs/aaps.md](docs/aaps.md) |
+| AgentLink | [docs/agentlink.md](docs/agentlink.md) |
 | Model selection and roles | [docs/model-selection.md](docs/model-selection.md) |
 | SCS mode | [docs/student-committee-supervisor.md](docs/student-committee-supervisor.md) |
 | Large-codebase engineering | [docs/large-codebase-engineering.md](docs/large-codebase-engineering.md) |

package/docs/agentlink.md

@@ -0,0 +1,113 @@
+# AgInTi AgentLink
+
+AgentLink is AgInTiFlow's local-first collaboration layer for multiple AgInTi sessions.
+
+It lets sessions coordinate through durable boards, typed messages, action contracts, safe session summaries, and evidence bundles. It does not let one session silently run tools inside another session.
+
+## Defaults
+
+```text
+local same-account session discovery: on
+manual board creation: on
+session inbox delivery: explicit
+network peer discovery: off
+raw session sharing: off
+```
+
+This keeps AgentLink useful by default without turning AgInTi into an uncontrolled swarm.
+
+## CLI
+
+```bash
+aginti agentlink status
+aginti agentlink peers
+aginti agentlink boards
+aginti agentlink create "Experiment board" --objective "Coordinate capture and analysis"
+aginti agentlink board default
+aginti agentlink send default <session-id> "Please report current status with evidence."
+aginti agentlink claim default "Record event-camera sample" --owner-session <session-id>
+aginti agentlink evidence default "Output file exists and hash verified" --path results/manifest.json
+aginti agentlink summary <session-id>
+```
+
+Aliases:
+
+```bash
+aginti link status
+aginti agents peers
+```
+
+Interactive CLI:
+
+```text
+/link
+/link peers
+/link board default
+```
+
+## Web API
+
+```text
+GET  /api/agentlink/status
+GET  /api/agentlink/peers
+GET  /api/agentlink/boards
+POST /api/agentlink/boards
+GET  /api/agentlink/boards/:boardId
+POST /api/agentlink/boards/:boardId/messages
+POST /api/agentlink/boards/:boardId/contracts
+POST /api/agentlink/boards/:boardId/evidence
+GET  /api/agentlink/sessions/:sessionId/summary
+```
+
+## Model Tools
+
+AgInTi sessions can use:
+
+- `agentlink_status`
+- `agentlink_list_peers`
+- `agentlink_create_board`
+- `agentlink_get_board`
+- `agentlink_send_message`
+- `agentlink_claim_task`
+- `agentlink_attach_evidence`
+- `agentlink_summarize_session`
+
+These tools are deterministic local runtime tools. They are not external MCP tools and they do not grant remote execution rights.
+
+## Storage
+
+AgentLink stores account-local state under:
+
+```text
+~/.agintiflow/agentlink/
+  identity.json
+  peers.json
+  boards/
+    <board-id>/
+      board.json
+      messages.jsonl
+      events.jsonl
+      evidence.jsonl
+      contracts/
+```
+
+Session inbox delivery uses the existing session store:
+
+```text
+~/.agintiflow/sessions/<session-id>/inbox.jsonl
+```
+
+## Evidence Rule
+
+AgentLink messages are not proof. A completion claim should cite concrete evidence such as:
+
+- file path;
+- command output;
+- artifact id;
+- screenshot path;
+- report path;
+- log path;
+- checksum;
+- session summary with recent event types.
+
+Use `agentlink_attach_evidence` to persist that evidence on the board.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyingart/agintiflow",
-  "version": "0.20.192",
+  "version": "0.20.194",
   "type": "module",
   "description": "AgInTiFlow is a project-aware agent workspace for hybrid wet-dry R&D, hardware-aware intelligence, software automation, and industrial workflows.",
   "license": "Apache-2.0",
@@ -92,13 +92,14 @@
   "scripts": {
     "start": "node run.js",
     "web": "node web.js",
-    "check": "node --check run.js && node --check web.js && node --check bin/aginti-cli.js && node --check src/*.js && node --check src/mcp/*.js && node --check public/app.js && node --check scripts/seed-supervised-homework.js && node --check scripts/smoke-mcp.js && node --check scripts/smoke-web-ui.js && node --check scripts/smoke-scs-evidence-visibility.js && node --check scripts/fixtures/mcp-stdio-smoke-server.mjs",
+    "check": "node --check run.js && node --check web.js && node --check bin/aginti-cli.js && node --check src/*.js && node --check src/mcp/*.js && node --check public/app.js && node --check scripts/seed-supervised-homework.js && node --check scripts/smoke-agentlink.js && node --check scripts/smoke-mcp.js && node --check scripts/smoke-web-ui.js && node --check scripts/smoke-scs-evidence-visibility.js && node --check scripts/fixtures/mcp-stdio-smoke-server.mjs",
     "setup:toolchain-docker": "scripts/setup-agent-toolchain-docker.sh",
     "smoke:coding-tools": "node scripts/smoke-coding-tools.js",
     "smoke:dynamic-step-budget": "node scripts/smoke-dynamic-step-budget.js",
     "smoke:aaps-adapter": "node scripts/smoke-aaps-adapter.js",
     "smoke:auxiliary-tools": "node scripts/smoke-auxiliary-tools.js",
     "smoke:auth": "node scripts/smoke-auth.js",
+    "smoke:agentlink": "node scripts/smoke-agentlink.js",
     "smoke:canvas-artifacts": "node scripts/smoke-canvas-artifacts.js",
     "smoke:cli-chat": "node scripts/smoke-cli-chat.js",
     "smoke:docker-command": "node scripts/smoke-docker-command.js",
@@ -127,7 +128,7 @@
     "storage:migrate": "node bin/aginti-cli.js storage migrate",
     "publish:env": "node scripts/npm-publish-from-env.js publish --access public",
     "publish:env:whoami": "node scripts/npm-publish-from-env.js whoami",
-    "test": "npm run check && npm run smoke:runtime-compat && npm run smoke:autoupdate && npm run smoke:web-api && npm run smoke:web-ui && npm run smoke:web-autostart && npm run smoke:webapp-command && npm run smoke:web-port-fallback && npm run smoke:docker-command && npm run smoke:coding-tools && npm run smoke:dynamic-step-budget && npm run smoke:aaps-adapter && npm run smoke:auxiliary-tools && npm run smoke:perception-research && npm run smoke:auth && npm run smoke:canvas-artifacts && npm run smoke:capabilities && npm run smoke:mcp && npm run smoke:model-roles && npm run smoke:platform && npm run smoke:permission-modes && npm run smoke:skills && npm run smoke:skillmesh && npm run smoke:tmux-tools && npm run smoke:long-jobs && npm run smoke:cli-chat && npm run smoke:inbox",
+    "test": "npm run check && npm run smoke:runtime-compat && npm run smoke:autoupdate && npm run smoke:web-api && npm run smoke:web-ui && npm run smoke:web-autostart && npm run smoke:webapp-command && npm run smoke:web-port-fallback && npm run smoke:docker-command && npm run smoke:coding-tools && npm run smoke:dynamic-step-budget && npm run smoke:aaps-adapter && npm run smoke:auxiliary-tools && npm run smoke:perception-research && npm run smoke:auth && npm run smoke:agentlink && npm run smoke:canvas-artifacts && npm run smoke:capabilities && npm run smoke:mcp && npm run smoke:model-roles && npm run smoke:platform && npm run smoke:permission-modes && npm run smoke:skills && npm run smoke:skillmesh && npm run smoke:tmux-tools && npm run smoke:long-jobs && npm run smoke:cli-chat && npm run smoke:inbox",
     "pack:dry-run": "npm pack --dry-run",
     "smoke:capabilities": "node scripts/smoke-capabilities.js"
   },