@namzu/zen 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# @namzu/zen
+
+## 1.0.0
+
+### Major Changes
+
+- c635b5a: Use `namzu --output-schema /absolute/path/schema.json` for native schema-constrained TUI answers. Unsupported or lossy schema conversion fails at launch; normal conversations remain unchanged. Supply the flag again on resume.
+
+  Enable native query admission for Codex, OpenRouter, DeepSeek, HTTP and Zen wire mappings. Codex forwards Responses text.format; HTTP maps schemas for both dialects. Zen messages requests use native format instead of hidden tool fallback, and Google requests preserve JSON Schema constraints. Endpoint/model support is still required and vendor errors remain errors.
+
+  Breaking for direct HTTP/Zen callers: an Anthropic-dialect response format can no longer be silently ignored or fall back to an output tool. Schema-free JSON and explicit strict:false are rejected. Use strict native JSON Schema on a capable model, or choose SDK structuredOutput.mode="tool" when native schema output is unavailable.
+
+  Anthropic transport retries now default to zero instead of the vendor SDK default of two. The host immediately receives classified HTTP 429 responses with Retry-After metadata instead of waiting invisibly inside the vendor client. Set AnthropicConfig.maxRetries to 2 to retain the former transport retry behavior.
+
+  Rate-limit guidance no longer claims automatic retries were exhausted when retry policy may have disabled them or refused the requested delay.
+
+### Minor Changes
+
+- 0795da3: Add optional Zen and Zen Go providers for OpenCode's services using Namzu's
+  existing model contract. Exact service/model catalogue entries select Chat Completions,
+  Responses, Anthropic Messages or Google streaming transport. Tool
+  continuations, native reasoning metadata, conversation attribution,
+  cancellation and classified provider errors remain part of the normal
+  Namzu kernel lifecycle.
+
+  The CLI exposes Zen (`zen`) and Zen Go (`zen-go`) in provider selection and
+  headless runs. Zen supports anonymous public models and optional credentials;
+  Go requires its own key. The actual Namzu
+  conversation is retained for service attribution across turns and resume.
+  The driver requires Node.js 20+ and a supported public model, or a real key
+  with a known model or explicit protocol. Bundled prices are estimates;
+  unsupported controls and content combinations are refused.
+
+- 4cac9ca: Enable Zen's current public models without requiring an account key or an
+  OpenCode installation. Anonymous SDK calls and the CLI's Zen default use
+  `muse-spark-1.3-contributor-free`. Omitted, blank or `public` Zen keys select
+  anonymous access, restricted to six explicitly supported free model IDs;
+  paid or unknown models still require a real key. The SDK keeps
+  `glm-5.3-flash` as the default for credentialed Zen and Go calls, and Go
+  continues to require its own API key.
+
+  The CLI uses environment keys first, then reuses separate `opencode` and
+  `opencode-go` API-key entries from `OPENCODE_AUTH_CONTENT` or OpenCode's
+  data-directory `auth.json`, including the paired Windows home on WSL when
+  no absolute XDG override is supplied.
+  It leaves that file unchanged and does not reinterpret OAuth records as
+  API keys. Explicit `OPENCODE_API_KEY=public` selects anonymous access and
+  suppresses secondary Zen key aliases and stored account keys. With no
+  credential, Zen appears as public access without a login
+  or key prompt. Public model availability and service limits remain under
+  the upstream service's control.
+
+  Expose `@namzu/zen/models` for catalogue functions and model types without
+  loading the four native transport adapters during provider selection.
+
+  Send `strict: false` for all Responses function tools so optional parameters,
+  including nested read/edit fields, remain optional. This fixes HTTP 400
+  schema rejection when a backend defaults omitted strictness to true.
+  Responses also declines the capability-dependent `enforceToolInputSchema`
+  hint for these general schemas; Namzu continues to validate inputs before
+  tool execution. Other protocols retain their existing enforcement behavior.

package/LICENSE.md

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Cogitave
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+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/README.md

@@ -0,0 +1,142 @@
+<!-- okf
+type: Reference
+title: "@namzu/zen"
+description: Zen and Zen Go model drivers for the Namzu kernel, with native protocol routing and conversation attribution.
+tags: [readme, package, provider, opencode]
+status: stable
+-->
+
+# @namzu/zen
+
+Zen and Zen Go model drivers for [Namzu](https://github.com/cogitave/namzu),
+connecting to OpenCode's Zen and Go services.
+Both implement the SDK's existing `LLMProvider` interface. Namzu continues to
+own the agent loop, tools, permissions, budgets, retries, persistence and
+delegation.
+
+Zen includes public models that work without an account key or an OpenCode
+installation. Namzu defaults anonymous Zen calls to Muse Spark 1.3 Contributor
+Free (`muse-spark-1.3-contributor-free`). Zen Go still requires its own API key.
+
+```bash
+pnpm add @namzu/sdk @namzu/zen zod@^3
+```
+
+Requires Node.js 20+ and `@namzu/sdk >=36.0.0`. The optional package uses the
+official AI SDK provider adapters directly through `LanguageModelV3.doStream`;
+it does not depend on the `ai` orchestration package or another Namzu provider.
+
+```ts
+import { generateSessionId, runAgent } from '@namzu/sdk'
+import { ZenProvider } from '@namzu/zen'
+
+const sessionId = generateSessionId()
+const provider = new ZenProvider({ sessionId })
+const { output, run, identity } = await runAgent({
+  provider,
+  model: 'muse-spark-1.3-contributor-free',
+  sessionId,
+  prompt: 'Explain what an agent kernel does.',
+  maxIterations: 4,
+})
+
+console.log(output)
+console.log(run.stopReason)
+console.log(identity)
+```
+
+This example makes a public model request without an account key. For paid
+Zen models, pass `apiKey`. For Go, use `ZenGoProvider` with its API key.
+SDK constructors do not read environment variables or credential files;
+that lookup belongs to the application or CLI.
+Keep one provider instance per conversation, and reuse its `sessionId`
+after restart. The CLI passes the actual Namzu conversation ID, including
+across resume and compaction.
+
+## Service and protocol selection
+
+| Service | Registry type | Default base URL | CLI environment |
+| --- | --- | --- | --- |
+| Zen | `zen` | `https://opencode.ai/zen/v1` | `OPENCODE_API_KEY`, then `OPENCODE_ZEN_API_KEY` |
+| Zen Go (Go service) | `zen-go` | `https://opencode.ai/zen/go/v1` | `OPENCODE_GO_API_KEY` |
+
+The SDK defaults anonymous Zen calls to `muse-spark-1.3-contributor-free`;
+Zen with a real key and Go default to `glm-5.3-flash`. The CLI's default Zen
+model is the free Muse model. Routes are selected from the exact service
+and model ID: `chat` uses Chat Completions, `responses` uses Responses,
+`messages` uses Anthropic Messages, and `google` uses streaming
+`generateContent`. The same model family can use different wires on Zen
+and Go. Unknown IDs require an explicit `protocol` configuration; model
+names are never used to guess a wire format. Anonymous access is restricted
+to six explicitly supported public model IDs; a protocol override does not
+grant access to paid or unknown models.
+
+A missing, blank or `public` Zen `apiKey` selects anonymous access. Public
+availability and service limits can change. For credentialed access, the CLI
+uses the environment variables above first, then reads OpenCode API-key
+entries from `OPENCODE_AUTH_CONTENT` when set, otherwise from
+`$XDG_DATA_HOME/opencode/auth.json` for an absolute XDG path or
+`~/.local/share/opencode/auth.json`. Without an absolute XDG override, WSL
+can also reuse the paired Windows home's file. It maps `opencode` to Zen and
+`opencode-go` to Go separately, ignores OAuth entries, and never changes the
+owner's file. With no key, Zen remains available as a public provider and
+does not require a login or key prompt.
+
+`ZenConfig` accepts `apiKey`, `sessionId`, `model`, `baseURL`, `timeout`
+and `protocol`, all optional. `ZenGoConfig` requires `apiKey` for Go.
+Timeout defaults to 120,000 milliseconds. A missing
+`sessionId` generates an ID once per instance. Every request carries
+`x-opencode-session` plus Namzu's current attribution headers.
+
+Registry-based applications call `registerZen()` and/or
+`registerZenGo()` once, then use `ProviderRegistry.create()` with the
+corresponding discriminated config. The package also exports
+`getZenModels(service)`, `findZenModel(service, id)`,
+`ZEN_BASE_URL`, `ZEN_GO_BASE_URL`, and `ZEN_CAPABILITIES`.
+The `@namzu/zen/models` subpath exposes the catalogue functions and model
+types without loading the native transport adapters.
+
+## History, controls and limits
+
+Text, ordinary tools, inline images and documents use the SDK message
+contract. Signed reasoning, encrypted Responses items and Gemini thought
+signatures retain native ordering in versioned replay state. Replay requires
+the original configured route, service, protocol, model, history prefix,
+and unchanged durable assistant text, calls and reasoning. A changed route
+or compacted history uses portable text/tool history without foreign native
+reasoning.
+
+Unsupported controls and histories are refused. In particular, unresolved
+stored attachments must be materialized first, document citation requests
+are unsupported, Chat Completions cannot carry rich tool results, and a
+failed rich tool result cannot preserve both visual content and failure
+status through this adapter API. Messages tool documents must be PDFs.
+Images explicitly marked with a valid durable `modelOmission` are omitted.
+Failed text results retain a native error flag on Messages and an explicit
+failure marker on the other wires.
+Provider-executed tools and generated-file output are unsupported.
+
+Reasoning effort levels come from the selected model's catalogue entry;
+an empty list means no selectable effort control. Thinking and sampling
+controls also depend on the wire. See the [SDK guide](../../../docs/sdk/zen.md)
+for configuration and refusal details.
+
+`listModels(signal?)` intersects the live service catalogue with supported
+bundled models and restricts anonymous results to the explicit public set.
+Static limits and USD-per-million-token prices are a pinned
+snapshot, not an invoice: context tiers, caches, Go peak/off-peak rates,
+subscription allowances and promotions can change the effective charge.
+
+Tests use the real provider adapters with local HTTP/SSE fixtures, including
+tool continuations, signatures, cancellation and error classification.
+An SDK kernel test executes a registered tool and feeds its result into the
+next model request before completing the run.
+On 2026-09-08, live text inference on `muse-spark-1.3-contributor-free`
+succeeded without an account key through installed OpenCode and Namzu's
+driver. A live Namzu `run-stream` call with low effort and production tools
+also read `verification.txt`, then returned its exact nonce, absent from
+the prompt, after two model requests. The read succeeded and the run ended
+with `end_turn`. This validates that model's public text and file-tool path;
+it does not establish every public or paid model, Go access, or billing.
+
+FSL-1.1-MIT, converting to MIT two years after each release.

package/dist/client.d.ts

@@ -0,0 +1,30 @@
+import { type ChatCompletionParams, type LLMProvider, type ModelInfo, type ProviderCapabilities, type ReasoningEffort, type StreamChunk, type ThinkingConfig } from '@namzu/sdk';
+import { type ZenService } from './models.js';
+import type { ZenConfig, ZenGoConfig } from './types.js';
+export declare const ZEN_CAPABILITIES: ProviderCapabilities;
+export declare const ZEN_BASE_URL = "https://opencode.ai/zen/v1";
+export declare const ZEN_GO_BASE_URL = "https://opencode.ai/zen/go/v1";
+/** A provider instance belongs to one conversation; it never owns an agent loop. */
+export declare class ZenProvider implements LLMProvider {
+    private readonly config;
+    readonly service: ZenService;
+    readonly id: 'zen' | 'zen-go';
+    readonly name: string;
+    readonly capabilities: ProviderCapabilities;
+    readonly sessionId: string;
+    private readonly baseURL;
+    private readonly timeout;
+    private readonly requestFetch;
+    private readonly apiKey;
+    private readonly anonymous;
+    constructor(config?: ZenConfig, service?: ZenService);
+    chatStream(params: ChatCompletionParams): AsyncIterable<StreamChunk>;
+    listModels(signal?: AbortSignal): Promise<ModelInfo[]>;
+    reasoningEffortLevelsFor(model: string, _thinking?: ThinkingConfig): readonly ReasoningEffort[] | undefined;
+    resolveContextWindow(model: string, signal?: AbortSignal): Promise<number | undefined>;
+    private failure;
+}
+export declare class ZenGoProvider extends ZenProvider {
+    constructor(config: ZenGoConfig);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAaA,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,oBAAoB,EAEzB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,cAAc,EAMnB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,aAAa,CAAA;AAG3D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExD,eAAO,MAAM,gBAAgB,EAAE,oBAS9B,CAAA;AAED,eAAO,MAAM,YAAY,+BAA+B,CAAA;AACxD,eAAO,MAAM,eAAe,kCAAkC,CAAA;AAE9D,oFAAoF;AACpF,qBAAa,WAAY,YAAW,WAAW;IAY7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,OAAO,EAAE,UAAU;IAZ7B,QAAQ,CAAC,EAAE,EAAE,KAAK,GAAG,QAAQ,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,uBAAmB;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGjB,MAAM,GAAE,SAAc,EAC9B,OAAO,GAAE,UAAkB;IA+C9B,UAAU,CAAC,MAAM,EAAE,oBAAoB,GAAG,aAAa,CAAC,WAAW,CAAC;IAsUrE,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoC5D,wBAAwB,CACvB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,cAAc,GACxB,SAAS,eAAe,EAAE,GAAG,SAAS;IAInC,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK5F,OAAO,CAAC,OAAO;CAuBf;AAED,qBAAa,aAAc,SAAQ,WAAW;gBACjC,MAAM,EAAE,WAAW;CAG/B"}