glm-acp-agent 1.0.0

package/dist/llm/glm-client.js

@@ -0,0 +1,217 @@
+import OpenAI from "openai";
+import { TOOL_DEFINITIONS } from "../tools/definitions.js";
+import { resolveApiKey } from "./credentials.js";
+import { debug, error } from "./logger.js";
+/** Default base URL for the Z.AI / Zhipu OpenAI-compatible API (Coding endpoint). */
+const DEFAULT_BASE_URL = "https://api.z.ai/api/coding/paas/v4";
+/** Default GLM model when neither client nor user has chosen one. */
+export const DEFAULT_MODEL = "glm-5.1";
+/**
+ * Curated list of GLM models the agent advertises to ACP clients via
+ * `SessionModelState.availableModels`. Users can override this list via the
+ * `ACP_GLM_AVAILABLE_MODELS` environment variable (comma-separated model ids).
+ *
+ * The descriptions are intentionally short — clients render them in compact
+ * model pickers.
+ */
+const BUILTIN_AVAILABLE_MODELS = [
+    {
+        modelId: "glm-5.1",
+        name: "GLM-5.1",
+        description: "Latest GLM reasoning model with thinking mode",
+    },
+    {
+        modelId: "glm-5-turbo",
+        name: "GLM-5 Turbo",
+        description: "Faster Coding Plan reasoning model",
+    },
+    {
+        modelId: "glm-4.7",
+        name: "GLM-4.7",
+        description: "200K-context reasoning model",
+    },
+    {
+        modelId: "glm-4.5-air",
+        name: "GLM-4.5 Air",
+        description: "Lightweight, lower-latency model",
+    },
+];
+/**
+ * Resolve the list of advertised models, allowing the user to override the
+ * built-in list via `ACP_GLM_AVAILABLE_MODELS`.
+ */
+export function getAvailableModels() {
+    const override = process.env["ACP_GLM_AVAILABLE_MODELS"];
+    if (!override)
+        return BUILTIN_AVAILABLE_MODELS;
+    const ids = override
+        .split(",")
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    if (ids.length === 0)
+        return BUILTIN_AVAILABLE_MODELS;
+    return ids.map((id) => {
+        const builtin = BUILTIN_AVAILABLE_MODELS.find((m) => m.modelId === id);
+        return builtin ?? { modelId: id, name: id };
+    });
+}
+/** Default model for new sessions: env override → built-in default. */
+export function getDefaultModel() {
+    return process.env["ACP_GLM_MODEL"] ?? DEFAULT_MODEL;
+}
+/**
+ * Wrapper around the OpenAI-compatible Zhipu AI (Z.AI) API.
+ *
+ * Uses the standard `openai` npm package pointed at `https://api.z.ai/api/paas/v4`
+ * so no Zhipu-specific SDK is required. The Z.AI service speaks the OpenAI
+ * Chat Completions wire format, plus a few GLM-specific extras (like the
+ * `thinking` field and `delta.reasoning_content` for reasoning tokens).
+ */
+export class GlmClient {
+    client;
+    maxTokens;
+    constructor() {
+        const apiKey = resolveApiKey();
+        if (!apiKey) {
+            throw new Error("No API key found. Set the Z_AI_API_KEY environment variable, or run `glm-acp-agent --setup` to store one.");
+        }
+        const baseURL = process.env["ACP_GLM_BASE_URL"] ?? DEFAULT_BASE_URL;
+        this.maxTokens = parseIntEnv("ACP_GLM_MAX_TOKENS", 8192);
+        this.client = new OpenAI({ apiKey, baseURL });
+    }
+    /**
+     * Stream a chat completion from the GLM model, yielding chunks as they arrive.
+     *
+     * Reasoning/thinking tokens (from GLM "thinking" mode) are mapped to
+     * `thinking` chunks so the ACP agent can forward them as `agent_thought_chunk`
+     * blocks.
+     */
+    async *streamChat(messages, signal, options) {
+        const model = options?.model ?? getDefaultModel();
+        const thinkingEnabled = parseThinking(model);
+        const tools = TOOL_DEFINITIONS.map((t) => ({
+            type: "function",
+            function: {
+                name: t.function.name,
+                description: t.function.description,
+                parameters: t.function.parameters,
+            },
+        }));
+        debug(`streamChat: model=${model} baseURL=${this.client.baseURL} messages=${messages.length} tools=${tools.length} thinking=${thinkingEnabled}`);
+        // The OpenAI SDK forwards unknown extra body fields verbatim, so we use
+        // that to pass GLM-specific fields like `thinking`.
+        const extraBody = {};
+        if (thinkingEnabled) {
+            extraBody["thinking"] = { type: "enabled" };
+        }
+        let stream;
+        try {
+            stream = await this.client.chat.completions.create({
+                model,
+                messages,
+                tools,
+                tool_choice: "auto",
+                stream: true,
+                // Always ask the API to include final usage in the streaming response.
+                stream_options: { include_usage: true },
+                max_tokens: this.maxTokens,
+                ...extraBody,
+            }, { signal });
+        }
+        catch (err) {
+            const status = err?.status;
+            const body = err?.error;
+            error(`streamChat request failed: status=${status}`, JSON.stringify(body) ?? String(err));
+            throw err;
+        }
+        // Tool call deltas arrive interleaved across chunks; assemble by index.
+        const pendingToolCalls = new Map();
+        let lastFinishReason;
+        for await (const chunk of stream) {
+            const choice = chunk.choices[0];
+            if (choice) {
+                const delta = choice.delta;
+                // Reasoning / thinking tokens (GLM "thinking" mode).
+                const reasoning = delta["reasoning_content"];
+                if (typeof reasoning === "string" && reasoning.length > 0) {
+                    yield { thinking: reasoning };
+                }
+                // Regular assistant text.
+                const content = delta["content"];
+                if (typeof content === "string" && content.length > 0) {
+                    yield { text: content };
+                }
+                // Tool call deltas.
+                const toolCallDeltas = delta["tool_calls"];
+                if (Array.isArray(toolCallDeltas)) {
+                    for (const tc of toolCallDeltas) {
+                        let pending = pendingToolCalls.get(tc.index);
+                        if (!pending) {
+                            pending = { id: "", name: "", arguments: "" };
+                            pendingToolCalls.set(tc.index, pending);
+                        }
+                        if (tc.id)
+                            pending.id = tc.id;
+                        if (tc.function?.name)
+                            pending.name = tc.function.name;
+                        if (tc.function?.arguments)
+                            pending.arguments += tc.function.arguments;
+                    }
+                }
+                if (choice.finish_reason) {
+                    lastFinishReason = choice.finish_reason;
+                }
+            }
+            // The final chunk on most providers (GLM included when
+            // include_usage: true) ships only a `usage` object with no choices.
+            const rawUsage = chunk.usage;
+            if (rawUsage) {
+                const usage = {
+                    inputTokens: rawUsage.prompt_tokens ?? 0,
+                    outputTokens: rawUsage.completion_tokens ?? 0,
+                    totalTokens: rawUsage.total_tokens ?? 0,
+                };
+                if (typeof rawUsage.prompt_tokens_details?.cached_tokens === "number") {
+                    usage.cachedReadTokens = rawUsage.prompt_tokens_details.cached_tokens;
+                }
+                if (typeof rawUsage.completion_tokens_details?.reasoning_tokens === "number") {
+                    usage.thoughtTokens = rawUsage.completion_tokens_details.reasoning_tokens;
+                }
+                debug(`streamChat usage: input=${usage.inputTokens} output=${usage.outputTokens} total=${usage.totalTokens}`);
+                yield { usage };
+            }
+        }
+        // Flush any assembled tool calls and emit a final done chunk. Only emit
+        // calls that have both an id and a name – partial entries can be left
+        // behind by upstream errors and would just confuse the agent loop.
+        for (const [, tc] of pendingToolCalls) {
+            if (tc.id && tc.name)
+                yield { toolCall: tc };
+        }
+        pendingToolCalls.clear();
+        yield { done: true, stopReason: lastFinishReason };
+    }
+}
+/** Parse an integer environment variable, falling back to a default. */
+function parseIntEnv(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+/**
+ * Decide whether to enable GLM "thinking" mode for a given model name.
+ *
+ * The user can force on/off via `ACP_GLM_THINKING=true|false`. Otherwise,
+ * we enable thinking for any model whose name suggests it supports it
+ * (the GLM-4.5 / GLM-4.6 / GLM-4.7 / GLM-5.x families).
+ */
+function parseThinking(model) {
+    const override = process.env["ACP_GLM_THINKING"];
+    if (override !== undefined) {
+        return override.toLowerCase() === "true" || override === "1";
+    }
+    return /^glm-(?:4\.[567]|5)/i.test(model);
+}
+//# sourceMappingURL=glm-client.js.map

package/dist/llm/glm-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glm-client.js","sourceRoot":"","sources":["../../src/llm/glm-client.ts"],"names":[],"mappings":"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"}

package/dist/llm/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Debug logging for the GLM ACP agent.
+ *
+ * Set `ACP_GLM_DEBUG=true` to enable verbose logging to stderr.
+ * `warn()` and `error()` always write to stderr regardless of the debug flag.
+ */
+/** Log a debug message. Only writes when `ACP_GLM_DEBUG=true`. */
+export declare function debug(...args: unknown[]): void;
+/** Log a warning. Always written to stderr. */
+export declare function warn(...args: unknown[]): void;
+/** Log an error. Always written to stderr. */
+export declare function error(...args: unknown[]): void;
+/** Mask all but the last 4 characters of a string (e.g. API key). */
+export declare function maskSecret(s: string): string;
+/** Returns true when debug logging is active (`ACP_GLM_DEBUG=true`). */
+export declare function isDebugEnabled(): boolean;
+/** Reset the DEBUG_ENABLED flag (used in tests). */
+export declare function _resetDebugEnabled(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/llm/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/llm/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,kEAAkE;AAClE,wBAAgB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE9C;AAED,+CAA+C;AAC/C,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE7C;AAED,8CAA8C;AAC9C,wBAAgB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE9C;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED,wEAAwE;AACxE,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/llm/logger.js

@@ -0,0 +1,44 @@
+/**
+ * Debug logging for the GLM ACP agent.
+ *
+ * Set `ACP_GLM_DEBUG=true` to enable verbose logging to stderr.
+ * `warn()` and `error()` always write to stderr regardless of the debug flag.
+ */
+const DEBUG_ENABLED = typeof process === "object" &&
+    typeof process.env === "object" &&
+    (process.env["ACP_GLM_DEBUG"] === "true" || process.env["ACP_GLM_DEBUG"] === "1");
+function timestamp() {
+    return new Date().toISOString().slice(11, 23);
+}
+function write(level, ...args) {
+    const prefix = `[glm-acp-agent] ${timestamp()} [${level}]`;
+    process.stderr.write(`${prefix} ${args.join(" ")}\n`);
+}
+/** Log a debug message. Only writes when `ACP_GLM_DEBUG=true`. */
+export function debug(...args) {
+    if (DEBUG_ENABLED)
+        write("DEBUG", ...args);
+}
+/** Log a warning. Always written to stderr. */
+export function warn(...args) {
+    write("WARN", ...args);
+}
+/** Log an error. Always written to stderr. */
+export function error(...args) {
+    write("ERROR", ...args);
+}
+/** Mask all but the last 4 characters of a string (e.g. API key). */
+export function maskSecret(s) {
+    if (s.length <= 4)
+        return "****";
+    return "****" + s.slice(-4);
+}
+/** Returns true when debug logging is active (`ACP_GLM_DEBUG=true`). */
+export function isDebugEnabled() {
+    return DEBUG_ENABLED;
+}
+/** Reset the DEBUG_ENABLED flag (used in tests). */
+export function _resetDebugEnabled() {
+    // no-op in production; tests monkey-patch this module's internals.
+}
+//# sourceMappingURL=logger.js.map

package/dist/llm/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/llm/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,aAAa,GACjB,OAAO,OAAO,KAAK,QAAQ;IAC3B,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;IAC/B,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,GAAG,CAAC,CAAC;AAEpF,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAG,IAAe;IAC9C,MAAM,MAAM,GAAG,mBAAmB,SAAS,EAAE,KAAK,KAAK,GAAG,CAAC;IAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,KAAK,CAAC,GAAG,IAAe;IACtC,IAAI,aAAa;QAAE,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,IAAI,CAAC,GAAG,IAAe;IACrC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,KAAK,CAAC,GAAG,IAAe;IACtC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACjC,OAAO,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc;IAC5B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,kBAAkB;IAChC,mEAAmE;AACrE,CAAC"}

package/dist/protocol/agent.d.ts

@@ -0,0 +1,77 @@
+import type { Agent, AgentSideConnection, InitializeRequest, InitializeResponse, NewSessionRequest, NewSessionResponse, PromptRequest, PromptResponse, CancelNotification, AuthenticateRequest, AuthenticateResponse, SetSessionModeRequest, SetSessionModeResponse, CloseSessionRequest, ListSessionsRequest, ListSessionsResponse, LoadSessionRequest, LoadSessionResponse, ForkSessionRequest, ForkSessionResponse, ResumeSessionRequest, ResumeSessionResponse, SetSessionModelRequest, SetSessionModelResponse } from "@agentclientprotocol/sdk";
+import { type GlmMessage, type GlmStreamChunk, type StreamChatOptions } from "../llm/glm-client.js";
+import { SessionStore } from "./session-store.js";
+import { type VisionMcpClient } from "../tools/vision-mcp-client.js";
+/**
+ * Optional dependencies for tests.
+ */
+export interface GlmAcpAgentOptions {
+    /** Override the GLM client (used in tests). */
+    glm?: {
+        streamChat: (messages: GlmMessage[], signal?: AbortSignal, options?: StreamChatOptions) => AsyncIterable<GlmStreamChunk>;
+    };
+    /** Maximum number of model/tool turns per single prompt. Default 20. */
+    maxTurns?: number;
+    /**
+     * Override the session store (used in tests). When undefined the agent
+     * uses an on-disk store rooted at `$ACP_GLM_SESSION_DIR` /
+     * `$XDG_STATE_HOME/glm-acp-agent/sessions` / `~/.local/state/glm-acp-agent/sessions`.
+     * Pass `null` to disable persistence entirely.
+     */
+    sessionStore?: SessionStore | null;
+    /**
+     * Vision MCP client used to analyze ACP image blocks via @z_ai/mcp-server.
+     * Pass `null` to disable vision entirely (image blocks degrade to a text
+     * placeholder). When undefined the agent lazy-creates a StdioVisionMcpClient
+     * on first use.
+     */
+    visionClient?: VisionMcpClient | null;
+}
+/**
+ * GlmAcpAgent implements the ACP `Agent` interface.
+ *
+ * It bridges the ACP protocol (via `AgentSideConnection`) and the Zhipu AI
+ * GLM series models (via `GlmClient`), providing a full prompt loop with
+ * tool-calling and streaming support.
+ */
+export declare class GlmAcpAgent implements Agent {
+    private connection;
+    private sessions;
+    private _glm;
+    private maxTurns;
+    private clientCapabilities;
+    private sessionStore;
+    private _visionClient;
+    private visionClientExplicit;
+    constructor(connection: AgentSideConnection, options?: GlmAcpAgentOptions);
+    private get glm();
+    private get visionClient();
+    initialize(params: InitializeRequest): Promise<InitializeResponse>;
+    authenticate(_params: AuthenticateRequest): Promise<AuthenticateResponse>;
+    newSession(params: NewSessionRequest): Promise<NewSessionResponse>;
+    unstable_setSessionModel(params: SetSessionModelRequest): Promise<SetSessionModelResponse>;
+    /** Build the SessionModelState we advertise on session create/load/resume/fork. */
+    private modelsState;
+    setSessionMode(_params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
+    prompt(params: PromptRequest): Promise<PromptResponse>;
+    cancel(params: CancelNotification): Promise<void>;
+    closeSession(params: CloseSessionRequest): Promise<void>;
+    listSessions(params: ListSessionsRequest): Promise<ListSessionsResponse>;
+    loadSession(params: LoadSessionRequest): Promise<LoadSessionResponse>;
+    unstable_forkSession(params: ForkSessionRequest): Promise<ForkSessionResponse>;
+    resumeSession(params: ResumeSessionRequest): Promise<ResumeSessionResponse>;
+    private snapshot;
+    private persistSession;
+    private requirePersisted;
+    private replayMessages;
+    /**
+     * Runs the full prompt/tool-calling loop until the model stops or is cancelled.
+     *
+     * Returns the ACP stop reason and optional token usage reported by the model.
+     */
+    private runPromptLoop;
+    private mapStopReason;
+    /** Names of tools we expose given the client's capabilities. */
+    private availableToolNames;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/protocol/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/protocol/agent.ts"],"names":[],"mappings":"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"}