open-multi-agent-kit 0.96.0 → 0.96.1

package/docs/sessions.md

@@ -17,6 +17,17 @@ omk --fork <path|id>    # Fork a session file or partial session ID into a new s
 
 Use `/session` in interactive mode to see the current session file, session ID, message count, tokens, and cost.
 
+Stored sessions can also be inspected or appended from scripts:
+
+```bash
+omk sdk session status [id] [--json]
+omk sdk session tail [id] [--limit 20]
+omk sdk session inspect [id]
+omk sdk session send <id> "message"
+```
+
+`send` requires an exact session ID and appends only when the session has no active owner; it does not connect to a running process or execute the message. See [SDK](sdk.md#inspect-persisted-sessions-from-the-cli) for full flags and exit codes.
+
 For the JSONL file format and SessionManager API, see [Session Format](session-format.md).
 
 ## Retries and Termination Events
@@ -33,6 +44,7 @@ If a retry or failover succeeds, the later attempt emits `completed` and becomes
 | `/new` | Start a new session |
 | `/name <name>` | Set the current session display name |
 | `/session` | Show session info |
+| `/goal [objective]` | Show or set the durable goal; `checkpoint <json>` records Goal/Core/Verified/Open/Next continuity |
 | `/tree` | Navigate the current session tree |
 | `/fork` | Create a new session from a previous user message |
 | `/clone` | Duplicate the current active branch into a new session |
@@ -40,6 +52,8 @@ If a retry or failover succeeds, the later attempt emits `completed` and becomes
 | `/export [file]` | Export session to HTML |
 | `/share` | Upload as private GitHub gist with shareable HTML link |
 
+`/goal` state lives under the working directory, not in one session file. Seam checkpoints are digest-correlated revisions in the same goal journal; session entries contain only their goal ID, revision, and digest. The unkeyed digest is not workspace authentication, so checkpoint prose loaded on resume is not promoted to user authority. See [Run Protocol](run-protocol.md#durable-goal-lifecycle).
+
 ## Resuming and Deleting Sessions
 
 `/resume` opens an interactive session picker for the current project. `omk -r` opens the same picker at startup.

package/docs/usage.md

@@ -45,12 +45,14 @@ Type `/` in the editor to open command completion. Extensions can register custo
 | `/new` | Start a new session |
 | `/name <name>` | Set session display name |
 | `/session` | Show session file, ID, messages, tokens, and cost |
+| `/goal [objective]` | Show or set the durable goal for the current working directory |
 | `/tree` | Jump to any point in the session and continue from there |
 | `/fork` | Create a new session from a previous user message |
 | `/clone` | Duplicate the current active branch into a new session |
 | `/compact [prompt]` | Manually compact context, optionally with custom instructions |
 | `/copy` | Copy last assistant message to clipboard |
 | `/export [file]` | Export session to HTML |
+| `/import <path.jsonl>` | Import a JSONL session and continue it |
 | `/share` | Upload as private GitHub gist with shareable HTML link |
 | `/reload` | Reload keybindings, extensions, skills, prompts, and context files |
 | `/hotkeys` | Show all keyboard shortcuts |
@@ -58,6 +60,25 @@ Type `/` in the editor to open command completion. Extensions can register custo
 | `/star` | Open the OMK GitHub repository |
 | `/quit` | Quit omk |
 
+### Durable Goals
+
+Use `/goal <objective>` to create or update the durable goal for the current working directory; `/goal` without arguments shows its status. See [Run Protocol](run-protocol.md#durable-goal-lifecycle) for the authoritative persistence, round-limit, continuation, and SDK lifecycle rules.
+
+## Built-in Harness Safeguards
+
+`DefaultResourceLoader` enables these first-party safeguards:
+
+| Safeguard | Behavior | Opt out |
+| --- | --- | --- |
+| Identical-loop guard | Warns from the third consecutive identical tool call and blocks the sixth | `OMK_IDENTICAL_LOOP=0` |
+| Tool-pair repair | Removes unmatched tool-use and tool-result blocks from outbound context | `OMK_TOOL_PAIR_REPAIR=0` |
+| Model prompt presets | Adds model-specific execution guidance for supported Claude, Kimi, GLM, and Grok models | `OMK_PROMPT_PRESET=0` |
+| Goal controller | Registers `/goal` and continues active goals within their round limit | `OMK_GOAL_CONTROLLER=0` |
+
+These built-ins remain active with `--no-extensions`. A custom `ResourceLoader` owns its own extension set and does not receive them automatically.
+
+Claude models use a clean prompt context by default: OMK keeps tools, skills, and the Claude preset but omits discovered `AGENTS.md` and `CLAUDE.md` files. This avoids provider false positives caused by unrelated instruction text. Set `OMK_CLAUDE_CONTEXT_FILES=1` to restore those files for Claude.
+
 ## Automatic Thinking Level Routing
 
 `/think <level>` sets the thinking level manually. Manual levels always win: choosing a concrete level leaves auto routing, so no auto router runs.
@@ -135,6 +156,17 @@ Useful session commands:
 - `/clone` duplicates the current active branch into a new session file.
 - `/compact` summarizes older messages to free context.
 
+External controllers can inspect stored sessions without starting the TUI:
+
+```bash
+omk sdk session status [id] [--json]
+omk sdk session tail [id] [--limit 20]
+omk sdk session inspect [id]
+omk sdk session send <id> "message"
+```
+
+`send` appends a user-message entry; it does not wake or execute an agent. See [SDK](sdk.md#inspect-persisted-sessions-from-the-cli) for flags and output formats.
+
 See [Sessions](sessions.md) and [Compaction](compaction.md) for details.
 
 ### Session Doctor and Recovery
@@ -279,6 +311,8 @@ cat README.md | omk -p "Summarize this text"
 
 Built-in tools: `read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`.
 
+With default OMP seams, a long text `read` returns a bounded window and continuation marker without creating a sidecar. With `OMK_OMP_SEAMS=0`, legacy truncation may write the selected window to `<absolute-source-path>.omk-spill.txt` and report that path. A first line that alone exceeds the byte cap is clipped without a sidecar. An inspection-only tool allowlist is therefore not a strict no-write filesystem boundary in legacy read mode.
+
 ### Resource Options
 
 | Option | Description |
@@ -346,7 +380,7 @@ omk --model sonnet:high "Solve this complex problem"
 # Limit model cycling
 omk --models "claude-*,gpt-4o"
 
-# Read-only mode
+# Inspection-only tool allowlist; legacy read mode may create a spill sidecar
 omk --tools read,grep,find,ls -p "Review the code"
 
 # Disable one extension or built-in tool while keeping the rest available
@@ -355,22 +389,10 @@ omk --exclude-tools ask_question
 
 ### Environment Variables
 
-| Variable | Description |
-| ---------- | ------------- |
-| `OMK_CODING_AGENT_DIR` | Override config directory; default is `~/.omk/agent` |
-| `OMK_CODING_AGENT_SESSION_DIR` | Override session storage directory; overridden by `--session-dir` |
-| `OMK_PACKAGE_DIR` | Override package directory, useful for Nix/Guix store paths |
-| `OMK_TOOL_SCHEDULER` | Override the tool scheduler with `dag-v2` or use `waves-v1` for process-local rollback |
-| `OMK_OFFLINE` | Disable startup network operations, including update checks, package update checks, and install/update telemetry |
-| `OMK_SKIP_VERSION_CHECK` | Skip the OMK version update check at startup. This prevents the `the OMK repository` latest-version request |
-| `OMK_TELEMETRY` | Override install/update telemetry and provider attribution headers: `1`/`true`/`yes` or `0`/`false`/`no`. This does not disable update checks |
-| `OMK_CACHE_RETENTION` | Set to `long` for extended prompt cache where supported |
-| `VISUAL`, `EDITOR` | External editor for Ctrl+G |
+See [Environment Variables](environment-variables.md) for the authoritative variable list and exact startup semantics.
 
 ## Design Principles
 
-OMK keeps the core small and pushes workflow-specific behavior into extensions, skills, prompt templates, and packages.
-
-It intentionally does not include built-in MCP, sub-agents, permission popups, plan mode, to-dos, or background bash. You can build or install those workflows as extensions or packages, or use external tools such as containers and tmux.
+OMK keeps the core small while shipping a first-party MCP client and a small default harness layer for loop detection, context repair, model guidance, and durable goals. Broader subagent runtimes, permission UIs, plan mode, and background bash remain extension or package concerns.
 
 For the full rationale, read the [blog post](https://mariozechner.at/posts/2025-11-30-omk-coding-agent/).

package/examples/extensions/custom-provider-anthropic/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "omk-extension-custom-provider-anthropic",
-  "version": "0.96.0",
+  "version": "0.96.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omk-extension-custom-provider-anthropic",
-      "version": "0.96.0",
+      "version": "0.96.1",
       "dependencies": {
         "@anthropic-ai/sdk": "0.52.0"
       }

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-custom-provider-anthropic",
 	"private": true,
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/custom-provider-gitlab-duo/index.ts

@@ -244,7 +244,12 @@ async function loginGitLab(callbacks: OAuthLoginCallbacks): Promise<OAuthCredent
 
 	callbacks.onAuth({ url: `${GITLAB_COM_URL}/oauth/authorize?${authParams.toString()}` });
 	const callbackUrl = await callbacks.onPrompt({ message: "Paste the callback URL:" });
-	const code = new URL(callbackUrl).searchParams.get("code");
+	let code: string | null = null;
+	try {
+		code = new URL(callbackUrl).searchParams.get("code");
+	} catch {
+		throw new Error("Invalid callback URL — paste the full redirect URL from the browser");
+	}
 	if (!code) throw new Error("No authorization code found in callback URL");
 
 	const tokenResponse = await fetch(`${GITLAB_COM_URL}/oauth/token`, {

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-custom-provider-gitlab-duo",
 	"private": true,
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/gondolin/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "omk-extension-gondolin",
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "omk-extension-gondolin",
-			"version": "0.96.0",
+			"version": "0.96.1",
 			"dependencies": {
 				"@earendil-works/gondolin": "0.12.0"
 			}

package/examples/extensions/gondolin/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-gondolin",
 	"private": true,
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/sandbox/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "omk-extension-sandbox",
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "omk-extension-sandbox",
-			"version": "0.96.0",
+			"version": "0.96.1",
 			"dependencies": {
 				"@anthropic-ai/sandbox-runtime": "0.0.26"
 			}

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-sandbox",
 	"private": true,
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "omk-extension-with-deps",
-  "version": "0.96.0",
+  "version": "0.96.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "omk-extension-with-deps",
-      "version": "0.96.0",
+      "version": "0.96.1",
       "dependencies": {
         "ms": "2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "omk-extension-with-deps",
 	"private": true,
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"type": "module",
 	"scripts": {
 		"clean": "echo 'nothing to clean'",

package/npm-shrinkwrap.json

@@ -1,17 +1,17 @@
 {
 	"name": "open-multi-agent-kit",
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "open-multi-agent-kit",
-			"version": "0.96.0",
+			"version": "0.96.1",
 			"license": "MIT",
 			"dependencies": {
-				"omk-agent-core": "^0.96.0",
-				"omk-ai": "^0.96.0",
-				"omk-tui": "^0.96.0",
+				"omk-agent-core": "^0.96.1",
+				"omk-ai": "^0.96.1",
+				"omk-tui": "^0.96.1",
 				"@silvia-odwyer/photon-node": "0.3.4",
 				"canonicalize": "4.0.0",
 				"chalk": "5.6.2",
@@ -27,8 +27,8 @@
 				"typebox": "1.3.11",
 				"undici": "8.10.0",
 				"yaml": "2.9.0",
-				"omk-adaptorch-wpl": "^0.96.0",
-				"omk-protocol": "^0.96.0"
+				"omk-adaptorch-wpl": "^0.96.1",
+				"omk-protocol": "^0.96.1"
 			},
 			"optionalDependencies": {
 				"@mariozechner/clipboard": "0.3.9"
@@ -1285,19 +1285,19 @@
 			}
 		},
 		"node_modules/omk-adaptorch-wpl": {
-			"version": "0.96.0",
-			"resolved": "https://registry.npmjs.org/omk-adaptorch-wpl/-/omk-adaptorch-wpl-0.96.0.tgz",
+			"version": "0.96.1",
+			"resolved": "https://registry.npmjs.org/omk-adaptorch-wpl/-/omk-adaptorch-wpl-0.96.1.tgz",
 			"license": "MIT",
 			"engines": {
 				"node": ">=22.19.0"
 			}
 		},
 		"node_modules/omk-agent-core": {
-			"version": "0.96.0",
-			"resolved": "https://registry.npmjs.org/omk-agent-core/-/omk-agent-core-0.96.0.tgz",
+			"version": "0.96.1",
+			"resolved": "https://registry.npmjs.org/omk-agent-core/-/omk-agent-core-0.96.1.tgz",
 			"license": "MIT",
 			"dependencies": {
-				"omk-ai": "^0.96.0",
+				"omk-ai": "^0.96.1",
 				"ignore": "7.0.6",
 				"typebox": "1.3.11",
 				"yaml": "2.9.0"
@@ -1307,8 +1307,8 @@
 			}
 		},
 		"node_modules/omk-ai": {
-			"version": "0.96.0",
-			"resolved": "https://registry.npmjs.org/omk-ai/-/omk-ai-0.96.0.tgz",
+			"version": "0.96.1",
+			"resolved": "https://registry.npmjs.org/omk-ai/-/omk-ai-0.96.1.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",
@@ -1330,16 +1330,16 @@
 			}
 		},
 		"node_modules/omk-protocol": {
-			"version": "0.96.0",
-			"resolved": "https://registry.npmjs.org/omk-protocol/-/omk-protocol-0.96.0.tgz",
+			"version": "0.96.1",
+			"resolved": "https://registry.npmjs.org/omk-protocol/-/omk-protocol-0.96.1.tgz",
 			"license": "MIT",
 			"engines": {
 				"node": ">=22.19.0"
 			}
 		},
 		"node_modules/omk-tui": {
-			"version": "0.96.0",
-			"resolved": "https://registry.npmjs.org/omk-tui/-/omk-tui-0.96.0.tgz",
+			"version": "0.96.1",
+			"resolved": "https://registry.npmjs.org/omk-tui/-/omk-tui-0.96.1.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"get-east-asian-width": "1.6.0",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "open-multi-agent-kit",
-	"version": "0.96.0",
+	"version": "0.96.1",
 	"description": "OMK (Open Multi-Agent Kit) coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"omkConfig": {
@@ -44,9 +44,9 @@
 		"postinstall": "node ./scripts/link-workspace-deps.mjs"
 	},
 	"dependencies": {
-		"omk-agent-core": "^0.96.0",
-		"omk-ai": "^0.96.0",
-		"omk-tui": "^0.96.0",
+		"omk-agent-core": "^0.96.1",
+		"omk-ai": "^0.96.1",
+		"omk-tui": "^0.96.1",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"canonicalize": "4.0.0",
 		"chalk": "5.6.2",
@@ -62,8 +62,8 @@
 		"typebox": "1.3.11",
 		"undici": "8.10.0",
 		"yaml": "2.9.0",
-		"omk-adaptorch-wpl": "^0.96.0",
-		"omk-protocol": "^0.96.0"
+		"omk-adaptorch-wpl": "^0.96.1",
+		"omk-protocol": "^0.96.1"
 	},
 	"overrides": {
 		"rimraf": "6.1.2",