@magpie-community/opencode-zen-free-auth 0.1.14 → 0.1.15

package/README.md

@@ -74,6 +74,16 @@ itself (`bash`, `edit`, `glob`, `grep`, `read`), described as not
 available. A call of one of them the agent doesn't have reaches the agent
 like any other.
 
+Zen's free tier also tells OpenCode's own requests by the environment
+block every OpenCode prompt ends with (`<env>`, a `Working directory:`
+line, `</env>`) in a system message. Another agent's request without one
+gets a small allowance a day and then `429 FreeUsageLimitError` ("Free
+models work in OpenCode") until 00:00 UTC, while OpenCode's go through.
+So a request whose system messages have no such block gets one added
+after the agent's own prompt (Anthropic `system` and Responses
+`instructions` likewise), its working directory said as unknown; a
+prompt that has one, as OpenCode's does, goes as it is.
+
 Now and then Zen closes a streamed Chat Completions reply before its
 `[DONE]`. When the reply has said something and no tool call of it is
 unfinished, it ends there as an ordinary answer, and its text says it was

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magpie-community/opencode-zen-free-auth",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "OpenCode Zen free models through the public credential, with native streaming protocols",
   "type": "module",
   "main": "./index.mjs",

package/provider.mjs

@@ -110,6 +110,59 @@ function normalizeTools(body, protocol) {
   return { declared };
 }
 
+// Zen's free tier serves a request as OpenCode's own only when one of its
+// system messages carries OpenCode's environment block: `<env>`, a
+// `Working directory:` line and `</env>`, as every OpenCode prompt ends.
+// A request without one (another agent's own prompt: Kimi Work's,
+// WorkBuddy's) gets a small allowance a day, then 429 FreeUsageLimitError
+// ("Free models work in OpenCode") until 00:00 UTC, whatever its headers
+// say; the same request with the block added is served (tried against
+// opencode.ai on 2026-10-25, deepseek-v4.1-flash-free and
+// glm-5.3-flash-free). In a user message or a tool description it doesn't
+// count, and `<ENV>` or `working directory:` don't either. The directory
+// isn't known here, and the agent's own prompt says it, so it is told as
+// unknown rather than as a path that would mislead the model.
+const ENVIRONMENT = "<env>\n  Working directory: unknown\n</env>";
+const HAS_ENVIRONMENT = /<env>[\s\S]*Working directory:[\s\S]*<\/env>/;
+
+function textOf(content) {
+  if (typeof content === "string") return content;
+  if (!Array.isArray(content)) return "";
+  return content.map((part) => (typeof part?.text === "string" ? part.text : "")).join("\n");
+}
+
+function withEnvironment(content) {
+  if (typeof content === "string") return content ? `${content}\n\n${ENVIRONMENT}` : ENVIRONMENT;
+  if (Array.isArray(content)) return [...content, { type: "text", text: ENVIRONMENT }];
+  return ENVIRONMENT;
+}
+
+const SYSTEM_ROLES = ["system", "developer"];
+
+export function addEnvironment(body, protocol) {
+  if (protocol === "anthropic") {
+    if (!HAS_ENVIRONMENT.test(textOf(body.system))) body.system = withEnvironment(body.system);
+    return;
+  }
+  const messages = protocol === "chat" ? body.messages : body.input;
+  const system = Array.isArray(messages)
+    ? messages.filter((message) => SYSTEM_ROLES.includes(message?.role))
+    : [];
+  if (system.some((message) => HAS_ENVIRONMENT.test(textOf(message.content)))) return;
+  if (protocol === "responses") {
+    if (!HAS_ENVIRONMENT.test(textOf(body.instructions)))
+      body.instructions = withEnvironment(body.instructions);
+    return;
+  }
+  // Added to the agent's own system message, so the prompt stays one
+  // system message, the same on every turn (its cache holds); one is put
+  // first when the agent sent none.
+  const first = system.find((message) => message.role === "system");
+  if (first) first.content = withEnvironment(first.content);
+  else if (Array.isArray(messages)) messages.unshift({ role: "system", content: ENVIRONMENT });
+  else body.messages = [{ role: "system", content: ENVIRONMENT }];
+}
+
 const ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
 let lastStamp = 0;
 let counter = 0;
@@ -319,6 +372,7 @@ async function server(_input, options = {}) {
             const streaming = body.stream === true;
             body.stream = true;
             const toolPolicy = normalizeTools(body, protocol);
+            addEnvironment(body, protocol);
             if (protocol === "chat")
               body.stream_options = { ...body.stream_options, include_usage: true };
             // Only what OpenCode 1.19.0 itself sends to its gateway, so a