@senpiper/sp-agent 0.1.6 → 0.1.7

package/INSTALL.md

@@ -0,0 +1,175 @@
+# Install SP Agent and SP Web
+
+This guide targets `@senpiper/sp-agent@0.1.7` and newer, which include SP Web.
+
+Gateway: **https://sp-api.staging.senpiper.com/**
+
+## Requirements
+
+- Node.js **22.19.0 or newer**, with npm. Node.js 24 LTS is recommended.
+- An SP Gateway API key supplied by your administrator.
+- A terminal and a web browser.
+
+The workspace terminal uses a native PTY. Linux source builds require Python 3,
+`make`, and a C/C++ compiler. npm compiles the addon when a suitable prebuilt
+binary is unavailable.
+
+## 1. Install
+
+```bash
+npm install --global @senpiper/sp-agent
+```
+
+One package installs both commands:
+
+- `sp`: the terminal coding agent.
+- `sp-web`: the browser workspace server.
+
+Check the installation:
+
+```bash
+sp --version
+sp --health-check
+sp-web --help
+```
+
+For the initial bundled-web release, the version should be `0.1.7` and the
+health check should print `ok`.
+
+### npm 12
+
+npm 12 blocks dependency install scripts unless you approve them. To allow the
+native workspace terminal to build:
+
+```bash
+npm install --global --allow-scripts=node-pty @senpiper/sp-agent
+```
+
+Without that approval, the applications can install while the workspace
+terminal remains unavailable. Do not use `--ignore-scripts` if you need the PTY.
+
+## 2. Connect to SP Gateway
+
+Start SP from your project directory:
+
+```bash
+cd /path/to/your/project
+sp
+```
+
+Inside SP, enter:
+
+```text
+/login https://sp-api.staging.senpiper.com/
+```
+
+Paste your gateway API key into the **masked API-key prompt**. Do not put the
+key in a chat message, README, or shell command.
+
+SP adds `/v1` to the supplied gateway URL, retrieves the available models,
+and selects the first model. If prompted, choose your role and which curated
+skills to install. You can run `/onboarding` later.
+
+Use `/model` in SP to choose another available model. To inspect the model
+catalog from a separate terminal:
+
+```bash
+sp --list-models
+```
+
+For CLI-only setup, the equivalent command is:
+
+```bash
+sp login --gateway-url https://sp-api.staging.senpiper.com/
+```
+
+That CLI prompt is not masked. Prefer `/login` inside SP when entering a key.
+
+## 3. Open SP Web
+
+Interactive SP starts the web sidecar automatically. Open:
+
+**http://127.0.0.1:30141**
+
+Keep an SP instance running to send prompts and manage live sessions. SP Web
+connects to SP; it does not create a second writer for the same history file.
+
+The workspace includes chat, native questions, files, Git diffs, and a terminal.
+Commits and permanent thread deletion require confirmation.
+
+### Manual web startup
+
+If you want to start the server yourself, disable automatic startup first:
+
+```bash
+SP_WEB_DISABLE=1 sp
+```
+
+Then, in another terminal:
+
+```bash
+sp-web
+```
+
+Do not launch another web server on a port already in use. For a custom port:
+
+```bash
+sp-web --port 30142 --no-open
+```
+
+Open `http://127.0.0.1:30142` yourself.
+
+## Configuration and credentials
+
+SP stores its configuration and history under:
+
+```text
+~/.sp/agent/
+```
+
+Use `SP_CODING_AGENT_DIR` to select another profile. Set it consistently for
+SP and any manually started SP Web process.
+
+The gateway key stays on the machine running SP. Browser users do not need to
+paste that key into SP Web. If web authentication is enabled with
+`SP_WEB_PASSWORD`, use username **`sp`** and the configured web password.
+The web password and the gateway API key are different credentials.
+
+Keep the default loopback bind unless you deliberately configure remote
+access. Remote access needs authentication and HTTPS through a trusted
+reverse proxy or a trusted VPN. The workspace shell runs as your OS user;
+it is not a sandbox.
+
+## Update or uninstall
+
+Update both applications together:
+
+```bash
+npm install --global @senpiper/sp-agent@latest
+```
+
+Use the npm 12 script-approval flag above when applicable. Restart SP and its
+web sidecar after updating, then refresh the browser. Existing processes do
+not load replacement code automatically.
+
+Uninstall the applications:
+
+```bash
+npm uninstall --global @senpiper/sp-agent
+```
+
+Uninstalling the package does not delete `~/.sp/agent`. Do not remove that
+directory unless you intend to delete its credentials, settings, and history.
+
+## Troubleshooting
+
+| Symptom | Check |
+| --- | --- |
+| `sp` or `sp-web` is not found | Open a new terminal and ensure your Node version manager's global npm bin directory is on `PATH`. |
+| npm reports `EACCES` | Use a Node version manager or a user-writable npm prefix instead of a system-owned global installation. |
+| `sp` is older than `0.1.7` | You have a release from before bundled SP Web. Check that the new release is available in your npm registry. |
+| Login returns `401` or `403` | Ask your administrator to verify the gateway API key and access permissions, then repeat `/login`. |
+| No gateway models appear | Check gateway connectivity and repeat `/login` to synchronize the catalog. |
+| SP Web has no live session | Start `sp` in the project and confirm both processes use the same SP profile. |
+| Port `30141` is already in use | Open the existing SP Web instance, or choose another port for a manually started server. |
+| Workspace terminal is unavailable | Check build tools and npm install-script approval for `node-pty`. |

package/README.md

@@ -1,24 +1,52 @@
 # @senpiper/sp-agent
 
-Thin Senpiper distribution of Pi. It owns the `sp` CLI and RPC launchers, uses `~/.sp/agent`, always bootstraps the exact SP extension package, and binds all supported model traffic to `sp-gateway`.
+SP is Senpiper's coding agent. This package includes the `sp` terminal application and SP Web, a browser workspace for the same sessions. It uses `~/.sp/agent` and routes model traffic through `sp-gateway`.
 
 ## Install
 
 Requires Node.js 22.19 or newer.
 
+See [the installation guide](INSTALL.md) for setup with
+`https://sp-api.staging.senpiper.com/`, gateway login, and SP Web.
+
 ```bash
 npm install --global @senpiper/sp-agent
 sp
 ```
 
-The public package includes its exact SP runtime and extension dependencies, so users only install `@senpiper/sp-agent`.
+One installation provides both commands:
+
+```bash
+sp         # Start the terminal agent and its SP Web sidecar
+sp-web     # Start SP Web directly
+```
+
+SP Web connects to running SP sessions. SP owns the agents and their history files; the web UI does not create a competing writer. Run `sp-web --help` for browser, address, port, and authentication options.
+
+The package bundles the SP runtime and required extensions, and installs the exact `@senpiper/sp-web` dependency automatically. You do not need a separate web installation.
+
+The workspace terminal uses `node-pty`. If its installer cannot use a prebuilt binary for your platform, npm compiles it locally. Linux source builds need Python 3, `make`, and a C/C++ compiler. Do not disable install scripts if you need the workspace terminal.
+
+npm 12 requires explicit approval for dependency install scripts. To enable the workspace PTY on that npm version:
+
+```bash
+npm install --global --allow-scripts=node-pty @senpiper/sp-agent
+```
+
+The ordinary install still provides both applications, but a blocked native build can leave the workspace terminal unavailable.
+
+Set `SP_WEB_DISABLE=1` to run SP without automatically starting the web sidecar. This does not uninstall SP Web.
 
 ## Publishing
 
-Validate the complete public tarball and a clean global installation:
+Build SP Web in a disposable copy of its repository, not a checkout running a development server. Pack the production build with `npm pack --ignore-scripts`.
+
+Pass that web tarball to the SP release command. Validate the complete public tarball and a clean global installation:
 
 ```bash
-npm run publish:sp:npm:check
+npm run publish:sp:npm:check -- \
+  --web-tarball /absolute/path/senpiper-sp-web-0.1.0.tgz \
+  --web-lockfile /absolute/path/web-build/package-lock.json
 ```
 
 Log in from the release machine with an npm account that has write access to the `@senpiper` scope, bump the public version, then publish directly from the repository:
@@ -27,9 +55,61 @@ Log in from the release machine with an npm account that has write access to the
 npm run login:sp:npm
 npm whoami --registry https://registry.npmjs.org
 npm run version:sp:npm -- patch
-npm run publish:sp:npm
+npm run publish:sp:npm -- \
+  --web-tarball /absolute/path/senpiper-sp-web-0.1.0.tgz \
+  --web-lockfile /absolute/path/web-build/package-lock.json
 ```
 
-The publishing command builds the full package, creates the single bundled tarball, verifies a clean global installation, and invokes `npm publish --access public`. It does not depend on Bitbucket or another CI service.
+The publishing command builds SP and verifies a clean global installation against the supplied web artifact. Publish that exact `@senpiper/sp-web` artifact before publishing SP. The private runtime and extension packages remain bundled and do not need separate public releases.
+
+The private `packages/sp-web-contract` workspace only records the required web version for source development. It is not the web application and is never used as the release artifact.
 
 The supported programmatic entry point is `@senpiper/sp-agent/sdk`. It does not expose an unbound session constructor.
+
+## Concurrent web sessions
+
+Interactive SP supplies an instance-owned session manager to its required bridge extension. Web `create_session {cwd}` and `resume_session {sessionFile}` return `{sessionId}` for an independently running session. Select its existing-format discovery descriptor to send commands. Terminal replacement and browser disconnection leave other sessions running.
+
+SDK hosts can use the same verified factory:
+
+```typescript
+import { createSpSessionManager } from "@senpiper/sp-agent/sdk";
+
+const sessions = await createSpSessionManager();
+try {
+  const { sessionId } = await sessions.create("/absolute/project");
+  // Discover the descriptor by sessionId and use its authenticated bridge.
+} finally {
+  await sessions.dispose();
+}
+```
+
+`createSpAgentSession()` also returns its cwd-bound `services` for hosts constructing an `AgentSessionRuntime`. Pass the manager as `createSpAgentSession({ sessions, ... })` in the runtime factory, then call `sessions.attachRuntime(runtime)` before binding a terminal UI to install file-acquisition guards. See `packages/sp-agent-extensions/CONCURRENT_SESSIONS.md` in the source repository for the protocol and lifetime rules.
+
+## Third-party notices
+
+SP includes Pi code under the MIT license below. SP Web's upstream license and T3 attribution are included in the installed `@senpiper/sp-web` package as `LICENSE` and `THIRD_PARTY_NOTICES.md`. Other dependencies retain their own licenses.
+
+```text
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { configureSpEnvironment } from \"./environment.ts\";\nimport { handleSpReleaseCommand } from \"./release-manager.ts\";\nimport { runSpRuntime } from \"./runtime-cli.ts\";\nimport { SP_AGENT_VERSION } from \"./version.ts\";\n\nfunction printHelp() {\n\tconsole.log(`sp-agent ${SP_AGENT_VERSION}\n\nUsage:\n  sp                              Start the interactive terminal\n  sp -p <prompt>                  Run a one-shot prompt\n  sp --mode json|rpc              Select a machine-readable mode\n  sp --list-models                List canonical sp-gateway models\n  sp login|logout|onboarding      Manage sp-gateway and curated skills\n  sp update|rollback|repair       Manage the active verified release\n  sp --help                       Show this help\n\nConfiguration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);\n}\n\nasync function run() {\n\tconfigureSpEnvironment();\n\tprocess.title = \"sp\";\n\tconst args = process.argv.slice(2);\n\tif (args.length === 1 && (args[0] === \"--version\" || args[0] === \"-v\")) {\n\t\tconsole.log(SP_AGENT_VERSION);\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--help\" || args[0] === \"-h\")) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\tif (await handleSpReleaseCommand(args)) return;\n\tawait runSpRuntime(args);\n}\n\nrun().catch((error) => {\n\tconsole.error(`Error: ${error instanceof Error ? error.message : String(error)}`);\n\tprocess.exitCode = 1;\n});\n"]}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { configureSpEnvironment } from \"./environment.ts\";\nimport { handleSpReleaseCommand } from \"./release-manager.ts\";\nimport { runSpRuntime } from \"./runtime-cli.ts\";\nimport { SP_AGENT_VERSION } from \"./version.ts\";\n\nfunction printHelp() {\n\tconsole.log(`sp-agent ${SP_AGENT_VERSION}\n\nUsage:\n  sp                              Start the interactive terminal\n  sp -p <prompt>                  Run a one-shot prompt\n  sp --mode json|rpc              Select a machine-readable mode\n  sp --list-models                List canonical sp-gateway models\n  sp login|logout|onboarding      Manage sp-gateway and curated skills\n  sp update|rollback|repair       Manage the active verified release\n  sp --help                       Show this help\n  sp-web                          Start the bundled browser workspace\n\nConfiguration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);\n}\n\nasync function run() {\n\tconfigureSpEnvironment();\n\tprocess.title = \"sp\";\n\tconst args = process.argv.slice(2);\n\tif (args.length === 1 && (args[0] === \"--version\" || args[0] === \"-v\")) {\n\t\tconsole.log(SP_AGENT_VERSION);\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--help\" || args[0] === \"-h\")) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\tif (await handleSpReleaseCommand(args)) return;\n\tawait runSpRuntime(args);\n}\n\nrun().catch((error) => {\n\tconsole.error(`Error: ${error instanceof Error ? error.message : String(error)}`);\n\tprocess.exitCode = 1;\n});\n"]}

package/dist/cli.js

@@ -14,6 +14,7 @@ Usage:
   sp login|logout|onboarding      Manage sp-gateway and curated skills
   sp update|rollback|repair       Manage the active verified release
   sp --help                       Show this help
+  sp-web                          Start the bundled browser workspace
 
 Configuration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);
 }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,SAAS,SAAS,GAAG;IACpB,OAAO,CAAC,GAAG,CAAC,YAAY,gBAAgB;;;;;;;;;;;+DAWsB,CAAC,CAAC;AAAA,CAChE;AAED,KAAK,UAAU,GAAG,GAAG;IACpB,sBAAsB,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO;IACR,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACrE,SAAS,EAAE,CAAC;QACZ,OAAO;IACR,CAAC;IACD,IAAI,MAAM,sBAAsB,CAAC,IAAI,CAAC;QAAE,OAAO;IAC/C,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;AAAA,CACzB;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AAAA,CACrB,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { configureSpEnvironment } from \"./environment.ts\";\nimport { handleSpReleaseCommand } from \"./release-manager.ts\";\nimport { runSpRuntime } from \"./runtime-cli.ts\";\nimport { SP_AGENT_VERSION } from \"./version.ts\";\n\nfunction printHelp() {\n\tconsole.log(`sp-agent ${SP_AGENT_VERSION}\n\nUsage:\n  sp                              Start the interactive terminal\n  sp -p <prompt>                  Run a one-shot prompt\n  sp --mode json|rpc              Select a machine-readable mode\n  sp --list-models                List canonical sp-gateway models\n  sp login|logout|onboarding      Manage sp-gateway and curated skills\n  sp update|rollback|repair       Manage the active verified release\n  sp --help                       Show this help\n\nConfiguration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);\n}\n\nasync function run() {\n\tconfigureSpEnvironment();\n\tprocess.title = \"sp\";\n\tconst args = process.argv.slice(2);\n\tif (args.length === 1 && (args[0] === \"--version\" || args[0] === \"-v\")) {\n\t\tconsole.log(SP_AGENT_VERSION);\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--help\" || args[0] === \"-h\")) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\tif (await handleSpReleaseCommand(args)) return;\n\tawait runSpRuntime(args);\n}\n\nrun().catch((error) => {\n\tconsole.error(`Error: ${error instanceof Error ? error.message : String(error)}`);\n\tprocess.exitCode = 1;\n});\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,SAAS,SAAS,GAAG;IACpB,OAAO,CAAC,GAAG,CAAC,YAAY,gBAAgB;;;;;;;;;;;;+DAYsB,CAAC,CAAC;AAAA,CAChE;AAED,KAAK,UAAU,GAAG,GAAG;IACpB,sBAAsB,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,OAAO;IACR,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACrE,SAAS,EAAE,CAAC;QACZ,OAAO;IACR,CAAC;IACD,IAAI,MAAM,sBAAsB,CAAC,IAAI,CAAC;QAAE,OAAO;IAC/C,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;AAAA,CACzB;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AAAA,CACrB,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { configureSpEnvironment } from \"./environment.ts\";\nimport { handleSpReleaseCommand } from \"./release-manager.ts\";\nimport { runSpRuntime } from \"./runtime-cli.ts\";\nimport { SP_AGENT_VERSION } from \"./version.ts\";\n\nfunction printHelp() {\n\tconsole.log(`sp-agent ${SP_AGENT_VERSION}\n\nUsage:\n  sp                              Start the interactive terminal\n  sp -p <prompt>                  Run a one-shot prompt\n  sp --mode json|rpc              Select a machine-readable mode\n  sp --list-models                List canonical sp-gateway models\n  sp login|logout|onboarding      Manage sp-gateway and curated skills\n  sp update|rollback|repair       Manage the active verified release\n  sp --help                       Show this help\n  sp-web                          Start the bundled browser workspace\n\nConfiguration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);\n}\n\nasync function run() {\n\tconfigureSpEnvironment();\n\tprocess.title = \"sp\";\n\tconst args = process.argv.slice(2);\n\tif (args.length === 1 && (args[0] === \"--version\" || args[0] === \"-v\")) {\n\t\tconsole.log(SP_AGENT_VERSION);\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--help\" || args[0] === \"-h\")) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\tif (await handleSpReleaseCommand(args)) return;\n\tawait runSpRuntime(args);\n}\n\nrun().catch((error) => {\n\tconsole.error(`Error: ${error instanceof Error ? error.message : String(error)}`);\n\tprocess.exitCode = 1;\n});\n"]}

package/dist/distribution.d.ts

@@ -1,4 +1,5 @@
 import type { Extension, ExtensionFactory, ExtensionRunnerOptions, MainOptions, ModelProviderPolicy } from "@senpiper/pi-coding-agent";
+import type { TerminalWebBridgeOptions } from "@senpiper/sp-agent-extensions";
 export { configureSpEnvironment } from "./environment.ts";
 export { SP_AGENT_VERSION } from "./version.ts";
 export declare const REQUIRED_EXTENSION_OWNER = "<inline:sp-agent>";
@@ -14,7 +15,7 @@ interface EmbeddedExtensionIdentity {
     };
 }
 export interface RequiredExtensionModule {
-    createSpAgentExtension: () => ExtensionFactory;
+    createSpAgentExtension: (options?: TerminalWebBridgeOptions) => ExtensionFactory;
     handleSpCommand: (args: string[]) => Promise<boolean>;
     readSpGatewayApiKey: () => unknown;
     readSpGatewayState: () => unknown;
@@ -36,6 +37,6 @@ export declare function createSpMainOptions(): Promise<MainOptions>;
 export declare const requiredExtension: {
     readonly name: "@senpiper/sp-agent-extensions";
     readonly version: "0.1.2";
-    readonly digest: "sha256:507c01fd321ee7875742dc043d9cf000e7e494fdc251a8f956808d5eba73afaf";
+    readonly digest: "sha256:1278e8448aa5a5321524d87cc8d0e8e25296bb1591e2b299f658db0cfb7af50d";
 };
 //# sourceMappingURL=distribution.d.ts.map

package/dist/distribution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../src/distribution.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,SAAS,EACT,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,mBAAmB,EACnB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAO5D,UAAU,yBAAyB;IAClC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,uBAAuB;IACvC,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;IAC/C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,mBAAmB,EAAE,MAAM,OAAO,CAAC;IACnC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,kCAAkC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,4BAA6B,SAAQ,kCAAkC;IAChF,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAoDD,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,kCAAuC,QAqC/F;AAoBD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,oCAqBrF;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,uBAAuB,GAAG,mBAAmB,CASnG;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,sBAAsB,CAiBvG;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAAC,CAQhE;AAED,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, parse, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n\tExtension,\n\tExtensionFactory,\n\tExtensionRunnerOptions,\n\tMainOptions,\n\tModelProviderPolicy,\n} from \"@senpiper/pi-coding-agent\";\nimport { EMBEDDED_REQUIRED_EXTENSION_IDENTITY } from \"./extension-identity.generated.ts\";\n\nexport { configureSpEnvironment } from \"./environment.ts\";\nexport { SP_AGENT_VERSION } from \"./version.ts\";\n\ndeclare const SP_AGENT_COMPILED: boolean;\n\nexport const REQUIRED_EXTENSION_OWNER = \"<inline:sp-agent>\";\n\ninterface PackageManifest {\n\tname?: string;\n\tversion?: string;\n}\n\ninterface EmbeddedExtensionIdentity {\n\trequired: { name: string; version: string };\n\tartifact: { name: string; version: string; digest: string };\n}\n\nexport interface RequiredExtensionModule {\n\tcreateSpAgentExtension: () => ExtensionFactory;\n\thandleSpCommand: (args: string[]) => Promise<boolean>;\n\treadSpGatewayApiKey: () => unknown;\n\treadSpGatewayState: () => unknown;\n\tSP_GATEWAY_PROVIDER_ID: string;\n}\n\ninterface RequiredExtensionValidationOptions {\n\tcompiled?: boolean;\n\tembeddedIdentity?: EmbeddedExtensionIdentity;\n\tresolvedEntrypoint?: string;\n}\n\ninterface RequiredExtensionLoadOptions extends RequiredExtensionValidationOptions {\n\timportExtension?: (specifier: string) => Promise<unknown>;\n}\n\nfunction findPackageManifest(entrypoint: string) {\n\tlet directory = dirname(entrypoint);\n\tconst root = parse(directory).root;\n\twhile (directory !== root) {\n\t\tconst manifestPath = join(directory, \"package.json\");\n\t\tif (existsSync(manifestPath)) return manifestPath;\n\t\tdirectory = dirname(directory);\n\t}\n\treturn undefined;\n}\n\nfunction collectJavaScriptFiles(directory: string): string[] {\n\tconst files: string[] = [];\n\tfor (const entry of readdirSync(directory, { withFileTypes: true })) {\n\t\tconst path = join(directory, entry.name);\n\t\tif (entry.isDirectory()) files.push(...collectJavaScriptFiles(path));\n\t\telse if (entry.isFile() && entry.name.endsWith(\".js\")) files.push(path);\n\t}\n\treturn files.sort((left, right) => relative(directory, left).localeCompare(relative(directory, right)));\n}\n\nfunction digestArtifact(directory: string) {\n\tconst files = collectJavaScriptFiles(directory);\n\tif (files.length === 0) throw new Error(`Required extension artifact contains no JavaScript: ${directory}`);\n\tconst hash = createHash(\"sha256\");\n\tfor (const path of files) {\n\t\tconst artifactPath = relative(directory, path).replaceAll(\"\\\\\", \"/\");\n\t\tconst content = readFileSync(path);\n\t\thash.update(`${artifactPath}\\0${content.byteLength}\\0`);\n\t\thash.update(content);\n\t}\n\treturn `sha256:${hash.digest(\"hex\")}`;\n}\n\nfunction assertEmbeddedIdentity(identity: EmbeddedExtensionIdentity) {\n\tif (\n\t\tidentity.artifact.name !== identity.required.name ||\n\t\tidentity.artifact.version !== identity.required.version ||\n\t\t!/^sha256:[0-9a-f]{64}$/u.test(identity.artifact.digest)\n\t) {\n\t\tthrow new Error(\n\t\t\t`Required extension build identity mismatch: expected ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction isCompiledExecutable() {\n\treturn typeof SP_AGENT_COMPILED !== \"undefined\" && SP_AGENT_COMPILED;\n}\n\nexport function assertRequiredExtensionIdentity(options: RequiredExtensionValidationOptions = {}) {\n\tconst identity = options.embeddedIdentity ?? EMBEDDED_REQUIRED_EXTENSION_IDENTITY;\n\tassertEmbeddedIdentity(identity);\n\tif (options.compiled ?? isCompiledExecutable()) return;\n\n\tconst resolved = options.resolvedEntrypoint ?? import.meta.resolve(identity.required.name);\n\tif (!resolved.startsWith(\"file:\")) {\n\t\tthrow new Error(`Cannot verify required extension ${identity.required.name}: ${resolved}`);\n\t}\n\tconst entrypoint = fileURLToPath(resolved);\n\tconst manifestPath = findPackageManifest(entrypoint);\n\tif (!manifestPath) {\n\t\tthrow new Error(`Cannot find the manifest for required extension ${identity.required.name}.`);\n\t}\n\tconst packageDirectory = dirname(manifestPath);\n\tconst entrypointRelativePath = relative(packageDirectory, entrypoint);\n\tif (\n\t\tentrypointRelativePath === \"\" ||\n\t\tentrypointRelativePath === \"..\" ||\n\t\tentrypointRelativePath.startsWith(\"../\") ||\n\t\tentrypointRelativePath.startsWith(\"..\\\\\") ||\n\t\tisAbsolute(entrypointRelativePath)\n\t) {\n\t\tthrow new Error(`Required extension entrypoint is outside its package: ${entrypoint}`);\n\t}\n\tconst manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as PackageManifest;\n\tif (manifest.name !== identity.required.name || manifest.version !== identity.required.version) {\n\t\tthrow new Error(\n\t\t\t`Required extension mismatch: expected ${identity.required.name}@${identity.required.version}, found ${manifest.name ?? \"unknown\"}@${manifest.version ?? \"unknown\"}.`,\n\t\t);\n\t}\n\tconst digest = digestArtifact(dirname(entrypoint));\n\tif (digest !== identity.artifact.digest) {\n\t\tthrow new Error(\n\t\t\t`Required extension authenticity check failed for ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction assertRequiredExtensionExports(value: unknown): asserts value is RequiredExtensionModule {\n\tif (typeof value !== \"object\" || value === null) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n\tconst module = value as Record<string, unknown>;\n\tif (\n\t\ttypeof module.createSpAgentExtension !== \"function\" ||\n\t\ttypeof module.handleSpCommand !== \"function\" ||\n\t\ttypeof module.readSpGatewayApiKey !== \"function\" ||\n\t\ttypeof module.readSpGatewayState !== \"function\" ||\n\t\ttypeof module.SP_GATEWAY_PROVIDER_ID !== \"string\"\n\t) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n}\n\nlet requiredExtensionPromise: Promise<RequiredExtensionModule> | undefined;\n\nexport async function loadRequiredExtension(options: RequiredExtensionLoadOptions = {}) {\n\tconst usesDefaultLoader = Object.keys(options).length === 0;\n\tif (usesDefaultLoader && requiredExtensionPromise) return requiredExtensionPromise;\n\n\tassertRequiredExtensionIdentity(options);\n\tconst compiled = options.compiled ?? isCompiledExecutable();\n\tconst specifier = compiled\n\t\t? EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name\n\t\t: (options.resolvedEntrypoint ?? import.meta.resolve(EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name));\n\tconst load = async () => {\n\t\tconst imported = options.importExtension\n\t\t\t? await options.importExtension(specifier)\n\t\t\t: compiled\n\t\t\t\t? await import(\"@senpiper/sp-agent-extensions\")\n\t\t\t\t: await import(specifier);\n\t\tassertRequiredExtensionExports(imported);\n\t\treturn imported;\n\t};\n\tconst promise = load();\n\tif (usesDefaultLoader) requiredExtensionPromise = promise;\n\treturn promise;\n}\n\nexport function createSpModelProviderPolicy(extension: RequiredExtensionModule): ModelProviderPolicy {\n\tconst configured = extension.readSpGatewayState() !== undefined;\n\tif (configured) extension.readSpGatewayApiKey();\n\treturn {\n\t\tallowedProviderIds: [extension.SP_GATEWAY_PROVIDER_ID],\n\t\trequiredProviderIds: configured ? [extension.SP_GATEWAY_PROVIDER_ID] : [],\n\t\tallowModelConfiguration: false,\n\t\tproviderOwners: { [extension.SP_GATEWAY_PROVIDER_ID]: REQUIRED_EXTENSION_OWNER },\n\t};\n}\n\nexport function createSpExtensionRunnerOptions(extensions: readonly Extension[]): ExtensionRunnerOptions {\n\tconst owner = extensions.find((extension) => extension.path === REQUIRED_EXTENSION_OWNER);\n\tif (!owner) throw new Error(\"Required SP extension did not load.\");\n\treturn {\n\t\tcommandOwnership: {\n\t\t\treservedCommandNames: [\"login\", \"onboarding\", \"btw\"],\n\t\t\towners: new Map([\n\t\t\t\t[\"login\", owner],\n\t\t\t\t[\"onboarding\", owner],\n\t\t\t\t[\"btw\", owner],\n\t\t\t]),\n\t\t},\n\t\tresourceOwnership: {\n\t\t\ttoolOwners: new Map([[\"ask_user_question\", owner]]),\n\t\t\tentryRendererOwners: new Map([[\"sp-btw\", owner]]),\n\t\t},\n\t};\n}\n\nexport async function createSpMainOptions(): Promise<MainOptions> {\n\tconst extension = await loadRequiredExtension();\n\treturn {\n\t\textensionFactories: [{ name: \"sp-agent\", factory: extension.createSpAgentExtension() }],\n\t\tincludeBuiltInExtensions: false,\n\t\tmodelProviderPolicy: createSpModelProviderPolicy(extension),\n\t\textensionRunnerOptionsResolver: createSpExtensionRunnerOptions,\n\t};\n}\n\nexport const requiredExtension = {\n\tname: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name,\n\tversion: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.version,\n\tdigest: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.artifact.digest,\n} as const;\n"]}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../src/distribution.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,SAAS,EACT,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,mBAAmB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAK9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAO5D,UAAU,yBAAyB;IAClC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,uBAAuB;IACvC,sBAAsB,EAAE,CAAC,OAAO,CAAC,EAAE,wBAAwB,KAAK,gBAAgB,CAAC;IACjF,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,mBAAmB,EAAE,MAAM,OAAO,CAAC;IACnC,kBAAkB,EAAE,MAAM,OAAO,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,kCAAkC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,4BAA6B,SAAQ,kCAAkC;IAChF,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAoDD,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,kCAAuC,QAqC/F;AAoBD,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,oCAqBrF;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,uBAAuB,GAAG,mBAAmB,CASnG;AAED,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,sBAAsB,CAevG;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAAC,CAqBhE;AAED,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, parse, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n\tExtension,\n\tExtensionFactory,\n\tExtensionRunnerOptions,\n\tMainOptions,\n\tModelProviderPolicy,\n} from \"@senpiper/pi-coding-agent\";\nimport type { TerminalWebBridgeOptions } from \"@senpiper/sp-agent-extensions\";\nimport { EMBEDDED_REQUIRED_EXTENSION_IDENTITY } from \"./extension-identity.generated.ts\";\nimport { createSpSessionManager } from \"./sdk.ts\";\nimport { spWriterLeases } from \"./writer-leases.ts\";\n\nexport { configureSpEnvironment } from \"./environment.ts\";\nexport { SP_AGENT_VERSION } from \"./version.ts\";\n\ndeclare const SP_AGENT_COMPILED: boolean;\n\nexport const REQUIRED_EXTENSION_OWNER = \"<inline:sp-agent>\";\n\ninterface PackageManifest {\n\tname?: string;\n\tversion?: string;\n}\n\ninterface EmbeddedExtensionIdentity {\n\trequired: { name: string; version: string };\n\tartifact: { name: string; version: string; digest: string };\n}\n\nexport interface RequiredExtensionModule {\n\tcreateSpAgentExtension: (options?: TerminalWebBridgeOptions) => ExtensionFactory;\n\thandleSpCommand: (args: string[]) => Promise<boolean>;\n\treadSpGatewayApiKey: () => unknown;\n\treadSpGatewayState: () => unknown;\n\tSP_GATEWAY_PROVIDER_ID: string;\n}\n\ninterface RequiredExtensionValidationOptions {\n\tcompiled?: boolean;\n\tembeddedIdentity?: EmbeddedExtensionIdentity;\n\tresolvedEntrypoint?: string;\n}\n\ninterface RequiredExtensionLoadOptions extends RequiredExtensionValidationOptions {\n\timportExtension?: (specifier: string) => Promise<unknown>;\n}\n\nfunction findPackageManifest(entrypoint: string) {\n\tlet directory = dirname(entrypoint);\n\tconst root = parse(directory).root;\n\twhile (directory !== root) {\n\t\tconst manifestPath = join(directory, \"package.json\");\n\t\tif (existsSync(manifestPath)) return manifestPath;\n\t\tdirectory = dirname(directory);\n\t}\n\treturn undefined;\n}\n\nfunction collectJavaScriptFiles(directory: string): string[] {\n\tconst files: string[] = [];\n\tfor (const entry of readdirSync(directory, { withFileTypes: true })) {\n\t\tconst path = join(directory, entry.name);\n\t\tif (entry.isDirectory()) files.push(...collectJavaScriptFiles(path));\n\t\telse if (entry.isFile() && entry.name.endsWith(\".js\")) files.push(path);\n\t}\n\treturn files.sort((left, right) => relative(directory, left).localeCompare(relative(directory, right)));\n}\n\nfunction digestArtifact(directory: string) {\n\tconst files = collectJavaScriptFiles(directory);\n\tif (files.length === 0) throw new Error(`Required extension artifact contains no JavaScript: ${directory}`);\n\tconst hash = createHash(\"sha256\");\n\tfor (const path of files) {\n\t\tconst artifactPath = relative(directory, path).replaceAll(\"\\\\\", \"/\");\n\t\tconst content = readFileSync(path);\n\t\thash.update(`${artifactPath}\\0${content.byteLength}\\0`);\n\t\thash.update(content);\n\t}\n\treturn `sha256:${hash.digest(\"hex\")}`;\n}\n\nfunction assertEmbeddedIdentity(identity: EmbeddedExtensionIdentity) {\n\tif (\n\t\tidentity.artifact.name !== identity.required.name ||\n\t\tidentity.artifact.version !== identity.required.version ||\n\t\t!/^sha256:[0-9a-f]{64}$/u.test(identity.artifact.digest)\n\t) {\n\t\tthrow new Error(\n\t\t\t`Required extension build identity mismatch: expected ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction isCompiledExecutable() {\n\treturn typeof SP_AGENT_COMPILED !== \"undefined\" && SP_AGENT_COMPILED;\n}\n\nexport function assertRequiredExtensionIdentity(options: RequiredExtensionValidationOptions = {}) {\n\tconst identity = options.embeddedIdentity ?? EMBEDDED_REQUIRED_EXTENSION_IDENTITY;\n\tassertEmbeddedIdentity(identity);\n\tif (options.compiled ?? isCompiledExecutable()) return;\n\n\tconst resolved = options.resolvedEntrypoint ?? import.meta.resolve(identity.required.name);\n\tif (!resolved.startsWith(\"file:\")) {\n\t\tthrow new Error(`Cannot verify required extension ${identity.required.name}: ${resolved}`);\n\t}\n\tconst entrypoint = fileURLToPath(resolved);\n\tconst manifestPath = findPackageManifest(entrypoint);\n\tif (!manifestPath) {\n\t\tthrow new Error(`Cannot find the manifest for required extension ${identity.required.name}.`);\n\t}\n\tconst packageDirectory = dirname(manifestPath);\n\tconst entrypointRelativePath = relative(packageDirectory, entrypoint);\n\tif (\n\t\tentrypointRelativePath === \"\" ||\n\t\tentrypointRelativePath === \"..\" ||\n\t\tentrypointRelativePath.startsWith(\"../\") ||\n\t\tentrypointRelativePath.startsWith(\"..\\\\\") ||\n\t\tisAbsolute(entrypointRelativePath)\n\t) {\n\t\tthrow new Error(`Required extension entrypoint is outside its package: ${entrypoint}`);\n\t}\n\tconst manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as PackageManifest;\n\tif (manifest.name !== identity.required.name || manifest.version !== identity.required.version) {\n\t\tthrow new Error(\n\t\t\t`Required extension mismatch: expected ${identity.required.name}@${identity.required.version}, found ${manifest.name ?? \"unknown\"}@${manifest.version ?? \"unknown\"}.`,\n\t\t);\n\t}\n\tconst digest = digestArtifact(dirname(entrypoint));\n\tif (digest !== identity.artifact.digest) {\n\t\tthrow new Error(\n\t\t\t`Required extension authenticity check failed for ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction assertRequiredExtensionExports(value: unknown): asserts value is RequiredExtensionModule {\n\tif (typeof value !== \"object\" || value === null) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n\tconst module = value as Record<string, unknown>;\n\tif (\n\t\ttypeof module.createSpAgentExtension !== \"function\" ||\n\t\ttypeof module.handleSpCommand !== \"function\" ||\n\t\ttypeof module.readSpGatewayApiKey !== \"function\" ||\n\t\ttypeof module.readSpGatewayState !== \"function\" ||\n\t\ttypeof module.SP_GATEWAY_PROVIDER_ID !== \"string\"\n\t) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n}\n\nlet requiredExtensionPromise: Promise<RequiredExtensionModule> | undefined;\n\nexport async function loadRequiredExtension(options: RequiredExtensionLoadOptions = {}) {\n\tconst usesDefaultLoader = Object.keys(options).length === 0;\n\tif (usesDefaultLoader && requiredExtensionPromise) return requiredExtensionPromise;\n\n\tassertRequiredExtensionIdentity(options);\n\tconst compiled = options.compiled ?? isCompiledExecutable();\n\tconst specifier = compiled\n\t\t? EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name\n\t\t: (options.resolvedEntrypoint ?? import.meta.resolve(EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name));\n\tconst load = async () => {\n\t\tconst imported = options.importExtension\n\t\t\t? await options.importExtension(specifier)\n\t\t\t: compiled\n\t\t\t\t? await import(\"@senpiper/sp-agent-extensions\")\n\t\t\t\t: await import(specifier);\n\t\tassertRequiredExtensionExports(imported);\n\t\treturn imported;\n\t};\n\tconst promise = load();\n\tif (usesDefaultLoader) requiredExtensionPromise = promise;\n\treturn promise;\n}\n\nexport function createSpModelProviderPolicy(extension: RequiredExtensionModule): ModelProviderPolicy {\n\tconst configured = extension.readSpGatewayState() !== undefined;\n\tif (configured) extension.readSpGatewayApiKey();\n\treturn {\n\t\tallowedProviderIds: [extension.SP_GATEWAY_PROVIDER_ID],\n\t\trequiredProviderIds: configured ? [extension.SP_GATEWAY_PROVIDER_ID] : [],\n\t\tallowModelConfiguration: false,\n\t\tproviderOwners: { [extension.SP_GATEWAY_PROVIDER_ID]: REQUIRED_EXTENSION_OWNER },\n\t};\n}\n\nexport function createSpExtensionRunnerOptions(extensions: readonly Extension[]): ExtensionRunnerOptions {\n\tconst owner = extensions.find((extension) => extension.path === REQUIRED_EXTENSION_OWNER);\n\tif (!owner) throw new Error(\"Required SP extension did not load.\");\n\treturn {\n\t\tcommandOwnership: {\n\t\t\treservedCommandNames: [\"login\", \"onboarding\"],\n\t\t\towners: new Map([\n\t\t\t\t[\"login\", owner],\n\t\t\t\t[\"onboarding\", owner],\n\t\t\t]),\n\t\t},\n\t\tresourceOwnership: {\n\t\t\ttoolOwners: new Map([[\"ask_user_question\", owner]]),\n\t\t},\n\t};\n}\n\nexport async function createSpMainOptions(): Promise<MainOptions> {\n\tconst extension = await loadRequiredExtension();\n\tconst sessions = await createSpSessionManager();\n\treturn {\n\t\tsessionWriterLeaseProvider: spWriterLeases,\n\t\tonSessionHistoryRoot: (root, customSessionDir) => sessions.setHistoryRoot(root, customSessionDir),\n\t\tonSessionRuntime: (runtime) => sessions.attachRuntime(runtime),\n\t\textensionFactories: [\n\t\t\t{\n\t\t\t\tname: \"sp-agent\",\n\t\t\t\tfactory: extension.createSpAgentExtension({\n\t\t\t\t\tsessions,\n\t\t\t\t\twriterLeaseVersion: 1,\n\t\t\t\t\tonReady: (bridge) => sessions.trackBridge(bridge),\n\t\t\t\t}),\n\t\t\t},\n\t\t],\n\t\tincludeBuiltInExtensions: false,\n\t\tmodelProviderPolicy: createSpModelProviderPolicy(extension),\n\t\textensionRunnerOptionsResolver: createSpExtensionRunnerOptions,\n\t};\n}\n\nexport const requiredExtension = {\n\tname: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name,\n\tversion: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.version,\n\tdigest: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.artifact.digest,\n} as const;\n"]}

package/dist/distribution.js

@@ -11,6 +11,8 @@ import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, parse, relative } from "node:path";
 import { fileURLToPath } from "node:url";
 import { EMBEDDED_REQUIRED_EXTENSION_IDENTITY } from "./extension-identity.generated.js";
+import { createSpSessionManager } from "./sdk.js";
+import { spWriterLeases } from "./writer-leases.js";
 export { configureSpEnvironment } from "./environment.js";
 export { SP_AGENT_VERSION } from "./version.js";
 export const REQUIRED_EXTENSION_OWNER = "<inline:sp-agent>";
@@ -145,23 +147,34 @@ export function createSpExtensionRunnerOptions(extensions) {
         throw new Error("Required SP extension did not load.");
     return {
         commandOwnership: {
-            reservedCommandNames: ["login", "onboarding", "btw"],
+            reservedCommandNames: ["login", "onboarding"],
             owners: new Map([
                 ["login", owner],
                 ["onboarding", owner],
-                ["btw", owner],
             ]),
         },
         resourceOwnership: {
             toolOwners: new Map([["ask_user_question", owner]]),
-            entryRendererOwners: new Map([["sp-btw", owner]]),
         },
     };
 }
 export async function createSpMainOptions() {
     const extension = await loadRequiredExtension();
+    const sessions = await createSpSessionManager();
     return {
-        extensionFactories: [{ name: "sp-agent", factory: extension.createSpAgentExtension() }],
+        sessionWriterLeaseProvider: spWriterLeases,
+        onSessionHistoryRoot: (root, customSessionDir) => sessions.setHistoryRoot(root, customSessionDir),
+        onSessionRuntime: (runtime) => sessions.attachRuntime(runtime),
+        extensionFactories: [
+            {
+                name: "sp-agent",
+                factory: extension.createSpAgentExtension({
+                    sessions,
+                    writerLeaseVersion: 1,
+                    onReady: (bridge) => sessions.trackBridge(bridge),
+                }),
+            },
+        ],
         includeBuiltInExtensions: false,
         modelProviderPolicy: createSpModelProviderPolicy(extension),
         extensionRunnerOptionsResolver: createSpExtensionRunnerOptions,

package/dist/distribution.js.map

@@ -1 +1 @@
-{"version":3,"file":"distribution.js","sourceRoot":"","sources":["../src/distribution.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, parse, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n\tExtension,\n\tExtensionFactory,\n\tExtensionRunnerOptions,\n\tMainOptions,\n\tModelProviderPolicy,\n} from \"@senpiper/pi-coding-agent\";\nimport { EMBEDDED_REQUIRED_EXTENSION_IDENTITY } from \"./extension-identity.generated.ts\";\n\nexport { configureSpEnvironment } from \"./environment.ts\";\nexport { SP_AGENT_VERSION } from \"./version.ts\";\n\ndeclare const SP_AGENT_COMPILED: boolean;\n\nexport const REQUIRED_EXTENSION_OWNER = \"<inline:sp-agent>\";\n\ninterface PackageManifest {\n\tname?: string;\n\tversion?: string;\n}\n\ninterface EmbeddedExtensionIdentity {\n\trequired: { name: string; version: string };\n\tartifact: { name: string; version: string; digest: string };\n}\n\nexport interface RequiredExtensionModule {\n\tcreateSpAgentExtension: () => ExtensionFactory;\n\thandleSpCommand: (args: string[]) => Promise<boolean>;\n\treadSpGatewayApiKey: () => unknown;\n\treadSpGatewayState: () => unknown;\n\tSP_GATEWAY_PROVIDER_ID: string;\n}\n\ninterface RequiredExtensionValidationOptions {\n\tcompiled?: boolean;\n\tembeddedIdentity?: EmbeddedExtensionIdentity;\n\tresolvedEntrypoint?: string;\n}\n\ninterface RequiredExtensionLoadOptions extends RequiredExtensionValidationOptions {\n\timportExtension?: (specifier: string) => Promise<unknown>;\n}\n\nfunction findPackageManifest(entrypoint: string) {\n\tlet directory = dirname(entrypoint);\n\tconst root = parse(directory).root;\n\twhile (directory !== root) {\n\t\tconst manifestPath = join(directory, \"package.json\");\n\t\tif (existsSync(manifestPath)) return manifestPath;\n\t\tdirectory = dirname(directory);\n\t}\n\treturn undefined;\n}\n\nfunction collectJavaScriptFiles(directory: string): string[] {\n\tconst files: string[] = [];\n\tfor (const entry of readdirSync(directory, { withFileTypes: true })) {\n\t\tconst path = join(directory, entry.name);\n\t\tif (entry.isDirectory()) files.push(...collectJavaScriptFiles(path));\n\t\telse if (entry.isFile() && entry.name.endsWith(\".js\")) files.push(path);\n\t}\n\treturn files.sort((left, right) => relative(directory, left).localeCompare(relative(directory, right)));\n}\n\nfunction digestArtifact(directory: string) {\n\tconst files = collectJavaScriptFiles(directory);\n\tif (files.length === 0) throw new Error(`Required extension artifact contains no JavaScript: ${directory}`);\n\tconst hash = createHash(\"sha256\");\n\tfor (const path of files) {\n\t\tconst artifactPath = relative(directory, path).replaceAll(\"\\\\\", \"/\");\n\t\tconst content = readFileSync(path);\n\t\thash.update(`${artifactPath}\\0${content.byteLength}\\0`);\n\t\thash.update(content);\n\t}\n\treturn `sha256:${hash.digest(\"hex\")}`;\n}\n\nfunction assertEmbeddedIdentity(identity: EmbeddedExtensionIdentity) {\n\tif (\n\t\tidentity.artifact.name !== identity.required.name ||\n\t\tidentity.artifact.version !== identity.required.version ||\n\t\t!/^sha256:[0-9a-f]{64}$/u.test(identity.artifact.digest)\n\t) {\n\t\tthrow new Error(\n\t\t\t`Required extension build identity mismatch: expected ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction isCompiledExecutable() {\n\treturn typeof SP_AGENT_COMPILED !== \"undefined\" && SP_AGENT_COMPILED;\n}\n\nexport function assertRequiredExtensionIdentity(options: RequiredExtensionValidationOptions = {}) {\n\tconst identity = options.embeddedIdentity ?? EMBEDDED_REQUIRED_EXTENSION_IDENTITY;\n\tassertEmbeddedIdentity(identity);\n\tif (options.compiled ?? isCompiledExecutable()) return;\n\n\tconst resolved = options.resolvedEntrypoint ?? import.meta.resolve(identity.required.name);\n\tif (!resolved.startsWith(\"file:\")) {\n\t\tthrow new Error(`Cannot verify required extension ${identity.required.name}: ${resolved}`);\n\t}\n\tconst entrypoint = fileURLToPath(resolved);\n\tconst manifestPath = findPackageManifest(entrypoint);\n\tif (!manifestPath) {\n\t\tthrow new Error(`Cannot find the manifest for required extension ${identity.required.name}.`);\n\t}\n\tconst packageDirectory = dirname(manifestPath);\n\tconst entrypointRelativePath = relative(packageDirectory, entrypoint);\n\tif (\n\t\tentrypointRelativePath === \"\" ||\n\t\tentrypointRelativePath === \"..\" ||\n\t\tentrypointRelativePath.startsWith(\"../\") ||\n\t\tentrypointRelativePath.startsWith(\"..\\\\\") ||\n\t\tisAbsolute(entrypointRelativePath)\n\t) {\n\t\tthrow new Error(`Required extension entrypoint is outside its package: ${entrypoint}`);\n\t}\n\tconst manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as PackageManifest;\n\tif (manifest.name !== identity.required.name || manifest.version !== identity.required.version) {\n\t\tthrow new Error(\n\t\t\t`Required extension mismatch: expected ${identity.required.name}@${identity.required.version}, found ${manifest.name ?? \"unknown\"}@${manifest.version ?? \"unknown\"}.`,\n\t\t);\n\t}\n\tconst digest = digestArtifact(dirname(entrypoint));\n\tif (digest !== identity.artifact.digest) {\n\t\tthrow new Error(\n\t\t\t`Required extension authenticity check failed for ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction assertRequiredExtensionExports(value: unknown): asserts value is RequiredExtensionModule {\n\tif (typeof value !== \"object\" || value === null) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n\tconst module = value as Record<string, unknown>;\n\tif (\n\t\ttypeof module.createSpAgentExtension !== \"function\" ||\n\t\ttypeof module.handleSpCommand !== \"function\" ||\n\t\ttypeof module.readSpGatewayApiKey !== \"function\" ||\n\t\ttypeof module.readSpGatewayState !== \"function\" ||\n\t\ttypeof module.SP_GATEWAY_PROVIDER_ID !== \"string\"\n\t) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n}\n\nlet requiredExtensionPromise: Promise<RequiredExtensionModule> | undefined;\n\nexport async function loadRequiredExtension(options: RequiredExtensionLoadOptions = {}) {\n\tconst usesDefaultLoader = Object.keys(options).length === 0;\n\tif (usesDefaultLoader && requiredExtensionPromise) return requiredExtensionPromise;\n\n\tassertRequiredExtensionIdentity(options);\n\tconst compiled = options.compiled ?? isCompiledExecutable();\n\tconst specifier = compiled\n\t\t? EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name\n\t\t: (options.resolvedEntrypoint ?? import.meta.resolve(EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name));\n\tconst load = async () => {\n\t\tconst imported = options.importExtension\n\t\t\t? await options.importExtension(specifier)\n\t\t\t: compiled\n\t\t\t\t? await import(\"@senpiper/sp-agent-extensions\")\n\t\t\t\t: await import(specifier);\n\t\tassertRequiredExtensionExports(imported);\n\t\treturn imported;\n\t};\n\tconst promise = load();\n\tif (usesDefaultLoader) requiredExtensionPromise = promise;\n\treturn promise;\n}\n\nexport function createSpModelProviderPolicy(extension: RequiredExtensionModule): ModelProviderPolicy {\n\tconst configured = extension.readSpGatewayState() !== undefined;\n\tif (configured) extension.readSpGatewayApiKey();\n\treturn {\n\t\tallowedProviderIds: [extension.SP_GATEWAY_PROVIDER_ID],\n\t\trequiredProviderIds: configured ? [extension.SP_GATEWAY_PROVIDER_ID] : [],\n\t\tallowModelConfiguration: false,\n\t\tproviderOwners: { [extension.SP_GATEWAY_PROVIDER_ID]: REQUIRED_EXTENSION_OWNER },\n\t};\n}\n\nexport function createSpExtensionRunnerOptions(extensions: readonly Extension[]): ExtensionRunnerOptions {\n\tconst owner = extensions.find((extension) => extension.path === REQUIRED_EXTENSION_OWNER);\n\tif (!owner) throw new Error(\"Required SP extension did not load.\");\n\treturn {\n\t\tcommandOwnership: {\n\t\t\treservedCommandNames: [\"login\", \"onboarding\", \"btw\"],\n\t\t\towners: new Map([\n\t\t\t\t[\"login\", owner],\n\t\t\t\t[\"onboarding\", owner],\n\t\t\t\t[\"btw\", owner],\n\t\t\t]),\n\t\t},\n\t\tresourceOwnership: {\n\t\t\ttoolOwners: new Map([[\"ask_user_question\", owner]]),\n\t\t\tentryRendererOwners: new Map([[\"sp-btw\", owner]]),\n\t\t},\n\t};\n}\n\nexport async function createSpMainOptions(): Promise<MainOptions> {\n\tconst extension = await loadRequiredExtension();\n\treturn {\n\t\textensionFactories: [{ name: \"sp-agent\", factory: extension.createSpAgentExtension() }],\n\t\tincludeBuiltInExtensions: false,\n\t\tmodelProviderPolicy: createSpModelProviderPolicy(extension),\n\t\textensionRunnerOptionsResolver: createSpExtensionRunnerOptions,\n\t};\n}\n\nexport const requiredExtension = {\n\tname: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name,\n\tversion: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.version,\n\tdigest: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.artifact.digest,\n} as const;\n"]}
+{"version":3,"file":"distribution.js","sourceRoot":"","sources":["../src/distribution.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, join, parse, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type {\n\tExtension,\n\tExtensionFactory,\n\tExtensionRunnerOptions,\n\tMainOptions,\n\tModelProviderPolicy,\n} from \"@senpiper/pi-coding-agent\";\nimport type { TerminalWebBridgeOptions } from \"@senpiper/sp-agent-extensions\";\nimport { EMBEDDED_REQUIRED_EXTENSION_IDENTITY } from \"./extension-identity.generated.ts\";\nimport { createSpSessionManager } from \"./sdk.ts\";\nimport { spWriterLeases } from \"./writer-leases.ts\";\n\nexport { configureSpEnvironment } from \"./environment.ts\";\nexport { SP_AGENT_VERSION } from \"./version.ts\";\n\ndeclare const SP_AGENT_COMPILED: boolean;\n\nexport const REQUIRED_EXTENSION_OWNER = \"<inline:sp-agent>\";\n\ninterface PackageManifest {\n\tname?: string;\n\tversion?: string;\n}\n\ninterface EmbeddedExtensionIdentity {\n\trequired: { name: string; version: string };\n\tartifact: { name: string; version: string; digest: string };\n}\n\nexport interface RequiredExtensionModule {\n\tcreateSpAgentExtension: (options?: TerminalWebBridgeOptions) => ExtensionFactory;\n\thandleSpCommand: (args: string[]) => Promise<boolean>;\n\treadSpGatewayApiKey: () => unknown;\n\treadSpGatewayState: () => unknown;\n\tSP_GATEWAY_PROVIDER_ID: string;\n}\n\ninterface RequiredExtensionValidationOptions {\n\tcompiled?: boolean;\n\tembeddedIdentity?: EmbeddedExtensionIdentity;\n\tresolvedEntrypoint?: string;\n}\n\ninterface RequiredExtensionLoadOptions extends RequiredExtensionValidationOptions {\n\timportExtension?: (specifier: string) => Promise<unknown>;\n}\n\nfunction findPackageManifest(entrypoint: string) {\n\tlet directory = dirname(entrypoint);\n\tconst root = parse(directory).root;\n\twhile (directory !== root) {\n\t\tconst manifestPath = join(directory, \"package.json\");\n\t\tif (existsSync(manifestPath)) return manifestPath;\n\t\tdirectory = dirname(directory);\n\t}\n\treturn undefined;\n}\n\nfunction collectJavaScriptFiles(directory: string): string[] {\n\tconst files: string[] = [];\n\tfor (const entry of readdirSync(directory, { withFileTypes: true })) {\n\t\tconst path = join(directory, entry.name);\n\t\tif (entry.isDirectory()) files.push(...collectJavaScriptFiles(path));\n\t\telse if (entry.isFile() && entry.name.endsWith(\".js\")) files.push(path);\n\t}\n\treturn files.sort((left, right) => relative(directory, left).localeCompare(relative(directory, right)));\n}\n\nfunction digestArtifact(directory: string) {\n\tconst files = collectJavaScriptFiles(directory);\n\tif (files.length === 0) throw new Error(`Required extension artifact contains no JavaScript: ${directory}`);\n\tconst hash = createHash(\"sha256\");\n\tfor (const path of files) {\n\t\tconst artifactPath = relative(directory, path).replaceAll(\"\\\\\", \"/\");\n\t\tconst content = readFileSync(path);\n\t\thash.update(`${artifactPath}\\0${content.byteLength}\\0`);\n\t\thash.update(content);\n\t}\n\treturn `sha256:${hash.digest(\"hex\")}`;\n}\n\nfunction assertEmbeddedIdentity(identity: EmbeddedExtensionIdentity) {\n\tif (\n\t\tidentity.artifact.name !== identity.required.name ||\n\t\tidentity.artifact.version !== identity.required.version ||\n\t\t!/^sha256:[0-9a-f]{64}$/u.test(identity.artifact.digest)\n\t) {\n\t\tthrow new Error(\n\t\t\t`Required extension build identity mismatch: expected ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction isCompiledExecutable() {\n\treturn typeof SP_AGENT_COMPILED !== \"undefined\" && SP_AGENT_COMPILED;\n}\n\nexport function assertRequiredExtensionIdentity(options: RequiredExtensionValidationOptions = {}) {\n\tconst identity = options.embeddedIdentity ?? EMBEDDED_REQUIRED_EXTENSION_IDENTITY;\n\tassertEmbeddedIdentity(identity);\n\tif (options.compiled ?? isCompiledExecutable()) return;\n\n\tconst resolved = options.resolvedEntrypoint ?? import.meta.resolve(identity.required.name);\n\tif (!resolved.startsWith(\"file:\")) {\n\t\tthrow new Error(`Cannot verify required extension ${identity.required.name}: ${resolved}`);\n\t}\n\tconst entrypoint = fileURLToPath(resolved);\n\tconst manifestPath = findPackageManifest(entrypoint);\n\tif (!manifestPath) {\n\t\tthrow new Error(`Cannot find the manifest for required extension ${identity.required.name}.`);\n\t}\n\tconst packageDirectory = dirname(manifestPath);\n\tconst entrypointRelativePath = relative(packageDirectory, entrypoint);\n\tif (\n\t\tentrypointRelativePath === \"\" ||\n\t\tentrypointRelativePath === \"..\" ||\n\t\tentrypointRelativePath.startsWith(\"../\") ||\n\t\tentrypointRelativePath.startsWith(\"..\\\\\") ||\n\t\tisAbsolute(entrypointRelativePath)\n\t) {\n\t\tthrow new Error(`Required extension entrypoint is outside its package: ${entrypoint}`);\n\t}\n\tconst manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as PackageManifest;\n\tif (manifest.name !== identity.required.name || manifest.version !== identity.required.version) {\n\t\tthrow new Error(\n\t\t\t`Required extension mismatch: expected ${identity.required.name}@${identity.required.version}, found ${manifest.name ?? \"unknown\"}@${manifest.version ?? \"unknown\"}.`,\n\t\t);\n\t}\n\tconst digest = digestArtifact(dirname(entrypoint));\n\tif (digest !== identity.artifact.digest) {\n\t\tthrow new Error(\n\t\t\t`Required extension authenticity check failed for ${identity.required.name}@${identity.required.version}.`,\n\t\t);\n\t}\n}\n\nfunction assertRequiredExtensionExports(value: unknown): asserts value is RequiredExtensionModule {\n\tif (typeof value !== \"object\" || value === null) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n\tconst module = value as Record<string, unknown>;\n\tif (\n\t\ttypeof module.createSpAgentExtension !== \"function\" ||\n\t\ttypeof module.handleSpCommand !== \"function\" ||\n\t\ttypeof module.readSpGatewayApiKey !== \"function\" ||\n\t\ttypeof module.readSpGatewayState !== \"function\" ||\n\t\ttypeof module.SP_GATEWAY_PROVIDER_ID !== \"string\"\n\t) {\n\t\tthrow new Error(`Required extension ${requiredExtension.name}@${requiredExtension.version} is invalid.`);\n\t}\n}\n\nlet requiredExtensionPromise: Promise<RequiredExtensionModule> | undefined;\n\nexport async function loadRequiredExtension(options: RequiredExtensionLoadOptions = {}) {\n\tconst usesDefaultLoader = Object.keys(options).length === 0;\n\tif (usesDefaultLoader && requiredExtensionPromise) return requiredExtensionPromise;\n\n\tassertRequiredExtensionIdentity(options);\n\tconst compiled = options.compiled ?? isCompiledExecutable();\n\tconst specifier = compiled\n\t\t? EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name\n\t\t: (options.resolvedEntrypoint ?? import.meta.resolve(EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name));\n\tconst load = async () => {\n\t\tconst imported = options.importExtension\n\t\t\t? await options.importExtension(specifier)\n\t\t\t: compiled\n\t\t\t\t? await import(\"@senpiper/sp-agent-extensions\")\n\t\t\t\t: await import(specifier);\n\t\tassertRequiredExtensionExports(imported);\n\t\treturn imported;\n\t};\n\tconst promise = load();\n\tif (usesDefaultLoader) requiredExtensionPromise = promise;\n\treturn promise;\n}\n\nexport function createSpModelProviderPolicy(extension: RequiredExtensionModule): ModelProviderPolicy {\n\tconst configured = extension.readSpGatewayState() !== undefined;\n\tif (configured) extension.readSpGatewayApiKey();\n\treturn {\n\t\tallowedProviderIds: [extension.SP_GATEWAY_PROVIDER_ID],\n\t\trequiredProviderIds: configured ? [extension.SP_GATEWAY_PROVIDER_ID] : [],\n\t\tallowModelConfiguration: false,\n\t\tproviderOwners: { [extension.SP_GATEWAY_PROVIDER_ID]: REQUIRED_EXTENSION_OWNER },\n\t};\n}\n\nexport function createSpExtensionRunnerOptions(extensions: readonly Extension[]): ExtensionRunnerOptions {\n\tconst owner = extensions.find((extension) => extension.path === REQUIRED_EXTENSION_OWNER);\n\tif (!owner) throw new Error(\"Required SP extension did not load.\");\n\treturn {\n\t\tcommandOwnership: {\n\t\t\treservedCommandNames: [\"login\", \"onboarding\"],\n\t\t\towners: new Map([\n\t\t\t\t[\"login\", owner],\n\t\t\t\t[\"onboarding\", owner],\n\t\t\t]),\n\t\t},\n\t\tresourceOwnership: {\n\t\t\ttoolOwners: new Map([[\"ask_user_question\", owner]]),\n\t\t},\n\t};\n}\n\nexport async function createSpMainOptions(): Promise<MainOptions> {\n\tconst extension = await loadRequiredExtension();\n\tconst sessions = await createSpSessionManager();\n\treturn {\n\t\tsessionWriterLeaseProvider: spWriterLeases,\n\t\tonSessionHistoryRoot: (root, customSessionDir) => sessions.setHistoryRoot(root, customSessionDir),\n\t\tonSessionRuntime: (runtime) => sessions.attachRuntime(runtime),\n\t\textensionFactories: [\n\t\t\t{\n\t\t\t\tname: \"sp-agent\",\n\t\t\t\tfactory: extension.createSpAgentExtension({\n\t\t\t\t\tsessions,\n\t\t\t\t\twriterLeaseVersion: 1,\n\t\t\t\t\tonReady: (bridge) => sessions.trackBridge(bridge),\n\t\t\t\t}),\n\t\t\t},\n\t\t],\n\t\tincludeBuiltInExtensions: false,\n\t\tmodelProviderPolicy: createSpModelProviderPolicy(extension),\n\t\textensionRunnerOptionsResolver: createSpExtensionRunnerOptions,\n\t};\n}\n\nexport const requiredExtension = {\n\tname: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.name,\n\tversion: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.required.version,\n\tdigest: EMBEDDED_REQUIRED_EXTENSION_IDENTITY.artifact.digest,\n} as const;\n"]}

package/dist/extension-identity.generated.d.ts

@@ -6,7 +6,7 @@ export declare const EMBEDDED_REQUIRED_EXTENSION_IDENTITY: {
     readonly artifact: {
         readonly name: "@senpiper/sp-agent-extensions";
         readonly version: "0.1.2";
-        readonly digest: "sha256:507c01fd321ee7875742dc043d9cf000e7e494fdc251a8f956808d5eba73afaf";
+        readonly digest: "sha256:1278e8448aa5a5321524d87cc8d0e8e25296bb1591e2b299f658db0cfb7af50d";
     };
 };
 //# sourceMappingURL=extension-identity.generated.d.ts.map

package/dist/extension-identity.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension-identity.generated.d.ts","sourceRoot":"","sources":["../src/extension-identity.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oCAAoC;;;;;;;;;;CAUvC,CAAC","sourcesContent":["// Generated by scripts/generate-sp-extension-identity.mjs. Do not edit.\nexport const EMBEDDED_REQUIRED_EXTENSION_IDENTITY = {\n\trequired: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t},\n\tartifact: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t\tdigest: \"sha256:507c01fd321ee7875742dc043d9cf000e7e494fdc251a8f956808d5eba73afaf\",\n\t},\n} as const;\n"]}
+{"version":3,"file":"extension-identity.generated.d.ts","sourceRoot":"","sources":["../src/extension-identity.generated.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oCAAoC;;;;;;;;;;CAUvC,CAAC","sourcesContent":["// Generated by scripts/generate-sp-extension-identity.mjs. Do not edit.\nexport const EMBEDDED_REQUIRED_EXTENSION_IDENTITY = {\n\trequired: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t},\n\tartifact: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t\tdigest: \"sha256:1278e8448aa5a5321524d87cc8d0e8e25296bb1591e2b299f658db0cfb7af50d\",\n\t},\n} as const;\n"]}

package/dist/extension-identity.generated.js

@@ -7,7 +7,7 @@ export const EMBEDDED_REQUIRED_EXTENSION_IDENTITY = {
     artifact: {
         name: "@senpiper/sp-agent-extensions",
         version: "0.1.2",
-        digest: "sha256:507c01fd321ee7875742dc043d9cf000e7e494fdc251a8f956808d5eba73afaf",
+        digest: "sha256:1278e8448aa5a5321524d87cc8d0e8e25296bb1591e2b299f658db0cfb7af50d",
     },
 };
 //# sourceMappingURL=extension-identity.generated.js.map

package/dist/extension-identity.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-identity.generated.js","sourceRoot":"","sources":["../src/extension-identity.generated.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,oCAAoC,GAAG;IACnD,QAAQ,EAAE;QACT,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,OAAO;KAChB;IACD,QAAQ,EAAE;QACT,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,yEAAyE;KACjF;CACQ,CAAC","sourcesContent":["// Generated by scripts/generate-sp-extension-identity.mjs. Do not edit.\nexport const EMBEDDED_REQUIRED_EXTENSION_IDENTITY = {\n\trequired: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t},\n\tartifact: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t\tdigest: \"sha256:507c01fd321ee7875742dc043d9cf000e7e494fdc251a8f956808d5eba73afaf\",\n\t},\n} as const;\n"]}
+{"version":3,"file":"extension-identity.generated.js","sourceRoot":"","sources":["../src/extension-identity.generated.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,CAAC,MAAM,oCAAoC,GAAG;IACnD,QAAQ,EAAE;QACT,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,OAAO;KAChB;IACD,QAAQ,EAAE;QACT,IAAI,EAAE,+BAA+B;QACrC,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,yEAAyE;KACjF;CACQ,CAAC","sourcesContent":["// Generated by scripts/generate-sp-extension-identity.mjs. Do not edit.\nexport const EMBEDDED_REQUIRED_EXTENSION_IDENTITY = {\n\trequired: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t},\n\tartifact: {\n\t\tname: \"@senpiper/sp-agent-extensions\",\n\t\tversion: \"0.1.2\",\n\t\tdigest: \"sha256:1278e8448aa5a5321524d87cc8d0e8e25296bb1591e2b299f658db0cfb7af50d\",\n\t},\n} as const;\n"]}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { requiredExtension, SP_AGENT_VERSION } from "./distribution.ts";
-export { type CreateSpAgentSessionOptions, type CreateSpAgentSessionResult, createSpAgentSession, } from "./sdk.ts";
+export { type CreateSpAgentSessionOptions, type CreateSpAgentSessionResult, createSpAgentSession, createSpSessionManager, } from "./sdk.ts";
+export type { SpSessionManager } from "./session-manager.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACN,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,oBAAoB,GACpB,MAAM,UAAU,CAAC","sourcesContent":["export { requiredExtension, SP_AGENT_VERSION } from \"./distribution.ts\";\nexport {\n\ttype CreateSpAgentSessionOptions,\n\ttype CreateSpAgentSessionResult,\n\tcreateSpAgentSession,\n} from \"./sdk.ts\";\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACN,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,oBAAoB,EACpB,sBAAsB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export { requiredExtension, SP_AGENT_VERSION } from \"./distribution.ts\";\nexport {\n\ttype CreateSpAgentSessionOptions,\n\ttype CreateSpAgentSessionResult,\n\tcreateSpAgentSession,\n\tcreateSpSessionManager,\n} from \"./sdk.ts\";\nexport type { SpSessionManager } from \"./session-manager.ts\";\n"]}

package/dist/index.js

@@ -1,3 +1,3 @@
 export { requiredExtension, SP_AGENT_VERSION } from "./distribution.js";
-export { createSpAgentSession, } from "./sdk.js";
+export { createSpAgentSession, createSpSessionManager, } from "./sdk.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAGN,oBAAoB,GACpB,MAAM,UAAU,CAAC","sourcesContent":["export { requiredExtension, SP_AGENT_VERSION } from \"./distribution.ts\";\nexport {\n\ttype CreateSpAgentSessionOptions,\n\ttype CreateSpAgentSessionResult,\n\tcreateSpAgentSession,\n} from \"./sdk.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAGN,oBAAoB,EACpB,sBAAsB,GACtB,MAAM,UAAU,CAAC","sourcesContent":["export { requiredExtension, SP_AGENT_VERSION } from \"./distribution.ts\";\nexport {\n\ttype CreateSpAgentSessionOptions,\n\ttype CreateSpAgentSessionResult,\n\tcreateSpAgentSession,\n\tcreateSpSessionManager,\n} from \"./sdk.ts\";\nexport type { SpSessionManager } from \"./session-manager.ts\";\n"]}

package/dist/runtime-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../src/runtime-cli.ts"],"names":[],"mappings":"AAwBA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,iBAqBhD","sourcesContent":["import { main, SessionManager } from \"@senpiper/pi-coding-agent\";\nimport {\n\tconfigureSpEnvironment,\n\tcreateSpMainOptions,\n\tloadRequiredExtension,\n\tSP_AGENT_VERSION,\n} from \"./distribution.ts\";\nimport { createSpAgentSession } from \"./sdk.ts\";\n\nfunction printHelp() {\n\tconsole.log(`sp-agent ${SP_AGENT_VERSION}\n\nUsage:\n  sp                              Start the interactive terminal\n  sp -p <prompt>                  Run a one-shot prompt\n  sp --mode json|rpc              Select a machine-readable mode\n  sp --list-models                List canonical sp-gateway models\n  sp login|logout|onboarding      Manage sp-gateway and curated skills\n  sp update|rollback|repair       Manage the active verified release\n  sp --help                       Show this help\n\nConfiguration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);\n}\n\nexport async function runSpRuntime(args: string[]) {\n\tconfigureSpEnvironment();\n\tprocess.title = \"sp\";\n\tprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\tif (args.length === 1 && args[0] === \"--health-check\") {\n\t\tprocess.env.PI_OFFLINE = \"1\";\n\t\tawait createSpAgentSession({ sessionManager: SessionManager.inMemory() });\n\t\tconsole.log(\"ok\");\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--version\" || args[0] === \"-v\")) {\n\t\tconsole.log(SP_AGENT_VERSION);\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--help\" || args[0] === \"-h\")) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\tconst extension = await loadRequiredExtension();\n\tif (await extension.handleSpCommand(args)) return;\n\tawait main(args, await createSpMainOptions());\n}\n"]}
+{"version":3,"file":"runtime-cli.d.ts","sourceRoot":"","sources":["../src/runtime-cli.ts"],"names":[],"mappings":"AAyBA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,iBAqBhD","sourcesContent":["import { main, SessionManager } from \"@senpiper/pi-coding-agent\";\nimport {\n\tconfigureSpEnvironment,\n\tcreateSpMainOptions,\n\tloadRequiredExtension,\n\tSP_AGENT_VERSION,\n} from \"./distribution.ts\";\nimport { createSpAgentSession } from \"./sdk.ts\";\n\nfunction printHelp() {\n\tconsole.log(`sp-agent ${SP_AGENT_VERSION}\n\nUsage:\n  sp                              Start the interactive terminal\n  sp -p <prompt>                  Run a one-shot prompt\n  sp --mode json|rpc              Select a machine-readable mode\n  sp --list-models                List canonical sp-gateway models\n  sp login|logout|onboarding      Manage sp-gateway and curated skills\n  sp update|rollback|repair       Manage the active verified release\n  sp --help                       Show this help\n  sp-web                          Start the bundled browser workspace\n\nConfiguration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);\n}\n\nexport async function runSpRuntime(args: string[]) {\n\tconfigureSpEnvironment();\n\tprocess.title = \"sp\";\n\tprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\tif (args.length === 1 && args[0] === \"--health-check\") {\n\t\tprocess.env.PI_OFFLINE = \"1\";\n\t\tawait createSpAgentSession({ sessionManager: SessionManager.inMemory() });\n\t\tconsole.log(\"ok\");\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--version\" || args[0] === \"-v\")) {\n\t\tconsole.log(SP_AGENT_VERSION);\n\t\treturn;\n\t}\n\tif (args.length === 1 && (args[0] === \"--help\" || args[0] === \"-h\")) {\n\t\tprintHelp();\n\t\treturn;\n\t}\n\tconst extension = await loadRequiredExtension();\n\tif (await extension.handleSpCommand(args)) return;\n\tawait main(args, await createSpMainOptions());\n}\n"]}

package/dist/runtime-cli.js

@@ -12,6 +12,7 @@ Usage:
   sp login|logout|onboarding      Manage sp-gateway and curated skills
   sp update|rollback|repair       Manage the active verified release
   sp --help                       Show this help
+  sp-web                          Start the bundled browser workspace
 
 Configuration: ~/.sp/agent (override with SP_CODING_AGENT_DIR)`);
 }