@gaunt-sloth/agent 0.1.8 → 2.0.0-alpha.0

package/dist/core/gthAcpServer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @packageDocumentation
+ * Thin wrapper over `deepagents-acp`'s `DeepAgentsServer` that fixes how its filesystem backend is
+ * rooted, since 0.1.12 gets both the location and the path semantics wrong for an IDE-hosted agent.
+ *
+ * 1. **Per-session root.** deepagents-acp roots its backend once at `workspaceRoot ?? process.cwd()`
+ *    and IGNORES the `cwd` carried by every ACP `session/new` request. An ACP host (Zed, JetBrains)
+ *    spawns one long-lived agent subprocess and passes the real project root per session, so we
+ *    re-root the backend to `session/new.cwd`.
+ * 2. **Virtual-fs semantics.** deepagents-acp builds its backend WITHOUT `virtualMode`, so `/`
+ *    resolves to the OS root and `ls /` lists the whole machine — but deepagents' filesystem prompt
+ *    tells the model `/` is the workspace root (the convention the local runner uses via
+ *    `FilesystemBackend({ virtualMode: true })`). We switch the backend into virtual-fs mode so
+ *    `'/'`-rooted paths are workspace-relative.
+ *
+ * The server's connection handler dispatches `this.handleNewSession(params, conn)` dynamically, so
+ * we patch that instance method before `start()`. Both fixes reach into deepagents-acp internals and
+ * are guarded so a shape change degrades to a no-op rather than throwing; if a future deepagents-acp
+ * honors session cwd / virtual mode itself, this becomes a harmless re-assert.
+ */
+import { DeepAgentsServer, type DeepAgentsServerOptions } from 'deepagents-acp';
+/**
+ * Construct and start a deepagents-acp server that roots its filesystem backend at each ACP
+ * session's `cwd` and runs it in virtual-fs mode (so `/` is the workspace, not the OS root).
+ * Resolves once the stdio transport is listening.
+ */
+export declare function startGthAcpServer(options: DeepAgentsServerOptions): Promise<DeepAgentsServer>;

package/dist/core/gthAcpServer.js

@@ -0,0 +1,71 @@
+/**
+ * @packageDocumentation
+ * Thin wrapper over `deepagents-acp`'s `DeepAgentsServer` that fixes how its filesystem backend is
+ * rooted, since 0.1.12 gets both the location and the path semantics wrong for an IDE-hosted agent.
+ *
+ * 1. **Per-session root.** deepagents-acp roots its backend once at `workspaceRoot ?? process.cwd()`
+ *    and IGNORES the `cwd` carried by every ACP `session/new` request. An ACP host (Zed, JetBrains)
+ *    spawns one long-lived agent subprocess and passes the real project root per session, so we
+ *    re-root the backend to `session/new.cwd`.
+ * 2. **Virtual-fs semantics.** deepagents-acp builds its backend WITHOUT `virtualMode`, so `/`
+ *    resolves to the OS root and `ls /` lists the whole machine — but deepagents' filesystem prompt
+ *    tells the model `/` is the workspace root (the convention the local runner uses via
+ *    `FilesystemBackend({ virtualMode: true })`). We switch the backend into virtual-fs mode so
+ *    `'/'`-rooted paths are workspace-relative.
+ *
+ * The server's connection handler dispatches `this.handleNewSession(params, conn)` dynamically, so
+ * we patch that instance method before `start()`. Both fixes reach into deepagents-acp internals and
+ * are guarded so a shape change degrades to a no-op rather than throwing; if a future deepagents-acp
+ * honors session cwd / virtual mode itself, this becomes a harmless re-assert.
+ */
+import { DeepAgentsServer } from 'deepagents-acp';
+import { resolve } from 'node:path';
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+/**
+ * Put an ACP filesystem backend into deepagents' virtual-fs mode so `'/'`-rooted paths are
+ * workspace-relative (clamped under `cwd`), matching deepagents' prompt and the local runner.
+ *
+ * `virtualMode` covers the methods that route through `resolvePath` (ls) and the inline checks
+ * (glob/grep). The ACP read/write proxy uses its own `resolveAbsPath`, which ignores `virtualMode`,
+ * so override that too so proxied reads/writes hit the workspace, not the OS root.
+ */
+function configureVirtualFs(backend) {
+    backend.virtualMode = true;
+    backend.resolveAbsPath = (filePath) => resolve(backend.cwd ?? process.cwd(), String(filePath).replace(/^\/+/, ''));
+}
+/**
+ * Construct and start a deepagents-acp server that roots its filesystem backend at each ACP
+ * session's `cwd` and runs it in virtual-fs mode (so `/` is the workspace, not the OS root).
+ * Resolves once the stdio transport is listening.
+ */
+export async function startGthAcpServer(options) {
+    const server = new DeepAgentsServer(options);
+    const internals = server;
+    const original = internals.handleNewSession;
+    if (typeof original === 'function') {
+        const bound = original.bind(server);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        internals.handleNewSession = async (params, conn) => {
+            const result = await bound(params, conn);
+            const backends = internals.acpBackends;
+            const cwd = typeof params?.cwd === 'string' && params.cwd.length > 0 ? resolve(params.cwd) : undefined;
+            if (backends && backends.size > 0) {
+                for (const backend of backends.values()) {
+                    if (!backend || typeof backend !== 'object')
+                        continue;
+                    if (cwd)
+                        backend.cwd = cwd;
+                    configureVirtualFs(backend);
+                }
+                debugLog(`ACP session: virtual fs, root ${cwd ?? '[startup workspace]'}`);
+            }
+            return result;
+        };
+    }
+    else {
+        debugLog('deepagents-acp handleNewSession not found to patch; session fs rooting disabled');
+    }
+    await server.start();
+    return server;
+}
+//# sourceMappingURL=gthAcpServer.js.map

package/dist/core/gthAcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gthAcpServer.js","sourceRoot":"","sources":["../../src/core/gthAcpServer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,gBAAgB,EAAgC,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAiBjE;;;;;;;GAOG;AACH,SAAS,kBAAkB,CAAC,OAA0B;IACpD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,cAAc,GAAG,CAAC,QAAgB,EAAU,EAAE,CACpD,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,MAAuC,CAAC;IAE1D,MAAM,QAAQ,GAAG,SAAS,CAAC,gBAAgB,CAAC;IAC5C,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,8DAA8D;QAC9D,SAAS,CAAC,gBAAgB,GAAG,KAAK,EAAE,MAAW,EAAE,IAAS,EAAE,EAAE;YAC5D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,CAAC;YACvC,MAAM,GAAG,GACP,OAAO,MAAM,EAAE,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7F,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;oBACxC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;wBAAE,SAAS;oBACtD,IAAI,GAAG;wBAAE,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;oBAC3B,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC9B,CAAC;gBACD,QAAQ,CAAC,iCAAiC,GAAG,IAAI,qBAAqB,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,iFAAiF,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/gthDeepAgentFactory.d.ts

@@ -0,0 +1,8 @@
+import type { GthAgentFactory } from '@gaunt-sloth/core/core/types.js';
+/**
+ * A {@link GthAgentFactory} that produces a {@link GthDeepAgent}. Pass this to
+ * `GthAgentRunner` (its optional 3rd ctor arg) so the same runner drives a
+ * `createDeepAgent` graph instead of the lean default — without `core` ever
+ * importing `deepagents`.
+ */
+export declare const gthDeepAgentFactory: GthAgentFactory;

package/dist/core/gthDeepAgentFactory.js

@@ -0,0 +1,9 @@
+import { GthDeepAgent } from '#src/core/GthDeepAgent.js';
+/**
+ * A {@link GthAgentFactory} that produces a {@link GthDeepAgent}. Pass this to
+ * `GthAgentRunner` (its optional 3rd ctor arg) so the same runner drives a
+ * `createDeepAgent` graph instead of the lean default — without `core` ever
+ * importing `deepagents`.
+ */
+export const gthDeepAgentFactory = (statusUpdate, resolvers) => new GthDeepAgent(statusUpdate, resolvers);
+//# sourceMappingURL=gthDeepAgentFactory.js.map

package/dist/core/gthDeepAgentFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gthDeepAgentFactory.js","sourceRoot":"","sources":["../../src/core/gthDeepAgentFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAoB,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,CAC9E,IAAI,YAAY,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from '#src/modules/apiAgUiModule.js';
+export * from '#src/modules/acpModule.js';
+export * from '#src/modules/interactiveSessionModule.js';
+export * from '#src/modules/a2a/A2AClientWrapper.js';
+export * from '#src/tools/A2AAgentTool.js';
+export * from '#src/mcp/OAuthClientProviderImpl.js';
+export * from '#src/utils/mcpUtils.js';
+export { createResolvers } from '#src/resolvers.js';
+export * from '#src/builtInToolsConfig.js';
+export { resolveMiddleware } from '#src/middleware/registry.js';
+export { GthDeepAgent, type GthDeepAgentParams } from '#src/core/GthDeepAgent.js';
+export * from '#src/core/deepAgentPermissions.js';
+export { gthDeepAgentFactory } from '#src/core/gthDeepAgentFactory.js';

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from '#src/modules/apiAgUiModule.js';
+export * from '#src/modules/acpModule.js';
+export * from '#src/modules/interactiveSessionModule.js';
+export * from '#src/modules/a2a/A2AClientWrapper.js';
+export * from '#src/tools/A2AAgentTool.js';
+export * from '#src/mcp/OAuthClientProviderImpl.js';
+export * from '#src/utils/mcpUtils.js';
+export { createResolvers } from '#src/resolvers.js';
+// Tools + middleware (formerly @gaunt-sloth/tools)
+export * from '#src/builtInToolsConfig.js';
+export { resolveMiddleware } from '#src/middleware/registry.js';
+// Deep agent (createDeepAgent / deepagents) + the GthConfig→permission mapping
+export { GthDeepAgent } from '#src/core/GthDeepAgent.js';
+export * from '#src/core/deepAgentPermissions.js';
+export { gthDeepAgentFactory } from '#src/core/gthDeepAgentFactory.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0CAA0C,CAAC;AACzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AACpD,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,mDAAmD;AACnD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAA2B,MAAM,2BAA2B,CAAC;AAClF,cAAc,mCAAmC,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/mcp/OAuthClientProviderImpl.d.ts

@@ -0,0 +1,37 @@
+import type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
+import type { OAuthClientInformationFull, OAuthClientMetadata, OAuthTokens } from '@modelcontextprotocol/sdk/shared/auth.js';
+import { StreamableHTTPConnection } from '@langchain/mcp-adapters';
+import http from 'http';
+interface OAuthClientProviderConfig {
+    redirectUrl: string;
+    serverUrl: string;
+}
+/**
+ * Please note most of these "unused" methods are part of {@link OAuthClientProvider}
+ */
+export declare class OAuthClientProviderImpl implements OAuthClientProvider {
+    private config;
+    private innerState;
+    private storagePath;
+    private storageCache?;
+    constructor(config: OAuthClientProviderConfig);
+    private loadStorageData;
+    private saveStorageData;
+    state(): string | Promise<string>;
+    get redirectUrl(): string;
+    get clientMetadata(): OAuthClientMetadata;
+    saveClientInformation(clientInformation: OAuthClientInformationFull): Promise<void>;
+    clientInformation(): Promise<OAuthClientInformationFull | undefined>;
+    saveTokens(tokens: OAuthTokens): Promise<void>;
+    tokens(): OAuthTokens | undefined;
+    saveCodeVerifier(codeVerifier: string): Promise<void>;
+    codeVerifier(): Promise<string>;
+    redirectToAuthorization(authUrl: URL): Promise<void>;
+}
+export declare function createAuthProviderAndAuthenticate(mcpServer: StreamableHTTPConnection): Promise<OAuthClientProviderImpl>;
+export declare function createOAuthRedirectServer(path: string, portParam?: number): Promise<{
+    port: number;
+    server: http.Server;
+    codePromise: Promise<string>;
+}>;
+export {};

package/dist/mcp/OAuthClientProviderImpl.js

@@ -0,0 +1,223 @@
+import { auth } from '@modelcontextprotocol/sdk/client/auth.js';
+import express from 'express';
+import * as crypto from 'node:crypto';
+import { platform } from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { displayInfo } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { readFileSync, writeFileSync, existsSync, unlinkSync } from 'node:fs';
+import { getOAuthStoragePath } from '@gaunt-sloth/core/utils/globalConfigUtils.js';
+/**
+ * Please note most of these "unused" methods are part of {@link OAuthClientProvider}
+ */
+export class OAuthClientProviderImpl {
+    config;
+    innerState;
+    storagePath;
+    storageCache;
+    constructor(config) {
+        this.config = config;
+        this.innerState = crypto.randomUUID();
+        if (!this.config.redirectUrl) {
+            throw new Error('No redirect URL provided');
+        }
+        if (!this.config.serverUrl) {
+            throw new Error('No server URL provided');
+        }
+        this.storagePath = getOAuthStoragePath(this.config.serverUrl);
+    }
+    loadStorageData() {
+        // Return cached data if available
+        if (this.storageCache !== undefined) {
+            return this.storageCache;
+        }
+        // Read from file if cache is empty
+        if (existsSync(this.storagePath)) {
+            try {
+                const data = readFileSync(this.storagePath, 'utf-8');
+                const parsedData = JSON.parse(data);
+                // Wipe data if the in-memory cache is empty and file info is missing tokens
+                if (parsedData.clientInformation && !parsedData.tokens) {
+                    try {
+                        unlinkSync(this.storagePath);
+                        displayInfo('Deleted OAuth storage file (missing tokens)');
+                        this.storageCache = {};
+                        return this.storageCache;
+                    }
+                    catch (error) {
+                        displayInfo('Failed to delete OAuth storage file: ' + error);
+                    }
+                }
+                // Cache the loaded data
+                this.storageCache = parsedData;
+                return parsedData;
+            }
+            catch (error) {
+                displayInfo('Failed to load OAuth storage data: ' + error);
+                this.storageCache = {};
+                return this.storageCache;
+            }
+        }
+        // No file exists, cache empty object
+        this.storageCache = {};
+        return this.storageCache;
+    }
+    saveStorageData(data) {
+        try {
+            writeFileSync(this.storagePath, JSON.stringify(data, null, 2), 'utf-8');
+            // Update the cache when saving
+            this.storageCache = data;
+        }
+        catch (error) {
+            console.error('Failed to save OAuth storage data:', error);
+        }
+    }
+    state() {
+        return this.innerState;
+    }
+    // noinspection JSUnusedGlobalSymbols
+    get redirectUrl() {
+        return this.config.redirectUrl;
+    }
+    // noinspection JSUnusedGlobalSymbols
+    get clientMetadata() {
+        return {
+            redirect_uris: [this.config.redirectUrl],
+            client_name: 'Gaunt Sloth Assistant',
+            client_uri: 'https://gaunt-sloth-assistant.github.io/',
+            software_id: '1dd38b83-946b-4631-8855-66ee467bfd68',
+            scope: 'mcp:read mcp:write',
+            token_endpoint_auth_method: 'none',
+            grant_types: ['authorization_code', 'refresh_token'],
+            response_types: ['code'],
+        };
+    }
+    // noinspection JSUnusedGlobalSymbols
+    saveClientInformation(clientInformation) {
+        const data = this.loadStorageData();
+        data.clientInformation = clientInformation;
+        this.saveStorageData(data);
+        return Promise.resolve();
+    }
+    // noinspection JSUnusedGlobalSymbols
+    async clientInformation() {
+        const data = this.loadStorageData();
+        return Promise.resolve(data.clientInformation);
+    }
+    // noinspection JSUnusedGlobalSymbols
+    async saveTokens(tokens) {
+        const data = this.loadStorageData();
+        data.tokens = tokens;
+        this.saveStorageData(data);
+    }
+    // noinspection JSUnusedGlobalSymbols
+    tokens() {
+        const data = this.loadStorageData();
+        return data.tokens;
+    }
+    // noinspection JSUnusedGlobalSymbols
+    saveCodeVerifier(codeVerifier) {
+        const data = this.loadStorageData();
+        data.codeVerifier = codeVerifier;
+        this.saveStorageData(data);
+        return Promise.resolve();
+    }
+    // noinspection JSUnusedGlobalSymbols
+    codeVerifier() {
+        const data = this.loadStorageData();
+        if (!data.codeVerifier) {
+            throw new Error('No code verifier stored');
+        }
+        return Promise.resolve(data.codeVerifier);
+    }
+    // noinspection JSUnusedGlobalSymbols
+    async redirectToAuthorization(authUrl) {
+        displayInfo('Auth url: ' + authUrl.toString());
+        try {
+            const url = authUrl.toString();
+            displayInfo('Trying to open browser');
+            // Handle different platforms
+            const platformName = platform();
+            if (platformName === 'win32') {
+                // Windows - 'start' is a cmd.exe built-in, so we must invoke it via cmd
+                spawnSync('cmd', ['/c', 'start', '', url], { stdio: 'ignore' });
+            }
+            else if (platformName === 'darwin') {
+                // macOS
+                spawnSync('open', [url], { stdio: 'ignore' });
+            }
+            else {
+                // Linux and others
+                spawnSync('xdg-open', [url], { stdio: 'ignore' });
+            }
+        }
+        catch (error) {
+            displayInfo(`Failed to open browser: ${error}`);
+            displayInfo(`Please open ${authUrl.toString()} in your browser`);
+        }
+    }
+}
+export async function createAuthProviderAndAuthenticate(mcpServer) {
+    const { port, server, codePromise } = await createOAuthRedirectServer('/oauth/callback');
+    const authProvider = new OAuthClientProviderImpl({
+        redirectUrl: `http://localhost:${port}/oauth/callback`,
+        serverUrl: mcpServer.url,
+    });
+    const outcome = await auth(authProvider, { serverUrl: mcpServer.url });
+    if (outcome == 'REDIRECT') {
+        const authorizationCode = await codePromise;
+        await auth(authProvider, { serverUrl: mcpServer.url, authorizationCode });
+    }
+    else if (outcome == 'AUTHORIZED') {
+        try {
+            server.close();
+        }
+        catch { }
+        displayInfo('Authorized');
+    }
+    else {
+        throw new Error(`Unexpected Auth outcome: ${outcome}`);
+    }
+    return authProvider;
+}
+export function createOAuthRedirectServer(path, portParam = 0) {
+    const redirectApp = express();
+    return new Promise((resolve, reject) => {
+        const codePromise = new Promise((resolveCode, rejectCode) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            redirectApp.get(path, (req, res) => {
+                const code = req.query.code;
+                if (!code) {
+                    res.status(400).send('Error: No auth code received');
+                    rejectCode('Error: No auth code received');
+                    return;
+                }
+                res.send(`<div style="height: 80vh;text-align: center;display: flex;justify-content: center;align-items: center;">
+            <div>
+                <h1>Auth successful!</h1>
+                You may close this window and return to the Gaunt Sloth.
+                <div>
+                    <img src="data:image/bmp;base64,Qk02AwAAAAAAADYAAAAoAAAAEAAAABAAAAABABgAAAAAAAADAAAAAAAAAAAAAAAAAAAAAAAAnD98ZBtDTQ8sey9YOQobRA8nZx9OdyxahzZrMwERdCtShjZqLQUVLwgZKwUWKQYXsFCRq06KciJPnEh/n0GEmjuClDl9lzl/uFGglz56dChOm0h0SBInLgQVKwgZKgUVgzZchDRfqEeLsUmavFWjvV6joEGFizFvsU+Yw2CowWCiu1qdbCRNKgEQMAofMAcebSRIgC9bt1KdqEqNnD6BokGJqEaOvVmjqEWMu12ftFeYwGCjpUOMUxc8KQIRLAQWhjVmo0qGs1CYqEmOqEmPmjyArk2UrEyQr02TsU2WwV6pvF2eo0CKlDl+OgsiJwQSijZthS9qnDuAo0GFqESMmz2BijZtpUOLnT2CuVicyWmtsVCUjDh0p0KQbiVYJAQSkzx3kzZ7iS5rv2mn3Y3Gq0+Pgi1laCFOfyxmmTx/slCVmT55eihemzyGjTd6NwgfgSxokzl9qkuY4pLR+Lvg1H3EjTRzZB1IjTV3cCNWmjmAgC1diCxpjC1ulDd8RhAtdihbljl/vmK1v2WuuWGgtVWdjDVwgS5ldCVZcydckjl5kzh3ynGwxHOooT6DSA8sQQwkpUeTyGrBlTp8eCNZkzh1rEeSmDx9ZB9JcyNYkzh2tlek5pjT8q3bqU2PPQokJgEPhTVxy2nBkDd6kDV2qEaOwGOvvWGxuViqoUSNlDd6nj6FvmKq13zKnkiJMgUZKwUWPg4poUaOkzp+kTh7nkCExG60033Jym7C03zKsVOdiC9tjjR10W7IeThrKAAOMAUYJgUULgUZdCZdqkqYu1ersk+fvFyww2q4z3fDqUmXhy5ulTp/yWi/Txo6JgEPLgYZLQUXKQUVJwkaSxExq1GTxWW3t1SpsU+gv1mvnUOLjTJ3izh3dTRkJwEQKgQWLQYaLAgcLQUYLQYZLAERezZaiTtmXyFJgjp0ijt1iTlqOAsjNQ0pKQASJwUVKQYYLgUZLAQZLAgcLgUZMAUYZyVRfCthPQoiIQAJOgcgYyBLKAIRLAUZNwsoMQcfKAQV"
+                         width="16" height="16">
+                </div>
+            </div>
+        </div>`);
+                resolveCode(code);
+                if (server) {
+                    displayInfo('Cleaning auth redirect server...');
+                    server.close();
+                }
+            });
+        });
+        const server = redirectApp.listen(portParam, () => {
+            const addressInfo = server.address();
+            const port = addressInfo.port;
+            displayInfo(`OAuth callback server listening at ${port}`);
+            resolve({ port, server, codePromise });
+        });
+        server.on('error', (err) => {
+            // If the server fails to start, reject the outer promise.
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=OAuthClientProviderImpl.js.map

package/dist/mcp/OAuthClientProviderImpl.js.map

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

package/dist/middleware/binaryContentInjectionMiddleware.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @packageDocumentation
+ * Middleware to inject binary content (images, PDFs, audio) as HumanMessage.
+ *
+ * The gth_read_binary tool returns binary data as a special string format:
+ * gth_read_binary;type:${type};path:${encodedPath};data:${media_type};base64,${data}
+ * where path is URL-encoded to handle special characters like semicolons.
+ *
+ * This middleware:
+ * 1. Detects the gth_read_binary tool calls
+ * 2. Parses the special string format from ToolMessage content
+ * 3. Injects HumanMessage with binary content blocks before next model call
+ *
+ * This works around LangChain's limitation where ToolMessage doesn't properly
+ * support binary content blocks for most providers.
+ */
+import { type AgentMiddleware } from 'langchain';
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+export interface BinaryContentInjectionMiddlewareSettings {
+    name?: 'binary-content-injection';
+}
+export declare function createBinaryContentInjectionMiddleware(_settings: BinaryContentInjectionMiddlewareSettings, _gthConfig: GthConfig): Promise<AgentMiddleware>;

package/dist/middleware/binaryContentInjectionMiddleware.js

@@ -0,0 +1,125 @@
+/**
+ * @packageDocumentation
+ * Middleware to inject binary content (images, PDFs, audio) as HumanMessage.
+ *
+ * The gth_read_binary tool returns binary data as a special string format:
+ * gth_read_binary;type:${type};path:${encodedPath};data:${media_type};base64,${data}
+ * where path is URL-encoded to handle special characters like semicolons.
+ *
+ * This middleware:
+ * 1. Detects the gth_read_binary tool calls
+ * 2. Parses the special string format from ToolMessage content
+ * 3. Injects HumanMessage with binary content blocks before next model call
+ *
+ * This works around LangChain's limitation where ToolMessage doesn't properly
+ * support binary content blocks for most providers.
+ */
+import { createMiddleware } from 'langchain';
+import path from 'node:path';
+import { debugLog } from '@gaunt-sloth/core/utils/debugUtils.js';
+import { ToolMessage, HumanMessage } from '@langchain/core/messages';
+/**
+ * Parse the special binary format string returned by gth_read_binary tool.
+ * Format: gth_read_binary;type:${type};path:${encodedPath};data:${media_type};base64,${data}
+ * Path is URL-encoded to handle special characters.
+ */
+function parseBinaryContent(content) {
+    if (!content.startsWith('gth_read_binary;')) {
+        return null;
+    }
+    try {
+        const parts = content.split(';');
+        if (parts.length < 4) {
+            return null;
+        }
+        const typeMatch = parts[1]?.match(/^type:(.+)$/);
+        const pathMatch = parts[2]?.match(/^path:(.+)$/);
+        const dataMatch = parts[3]?.match(/^data:(.+)$/);
+        const base64Match = content.match(/;base64,(.+)$/);
+        if (!typeMatch || !pathMatch || !dataMatch || !base64Match) {
+            return null;
+        }
+        // Decode the URL-encoded path
+        const decodedPath = decodeURIComponent(pathMatch[1]);
+        return {
+            formatType: typeMatch[1],
+            path: decodedPath,
+            media_type: dataMatch[1],
+            data: base64Match[1],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function createContentBlock(binaryData) {
+    const { formatType, media_type, data } = binaryData;
+    return {
+        type: formatType,
+        source_type: 'base64',
+        mime_type: media_type,
+        data,
+        metadata: {
+            filename: path.basename(binaryData.path),
+        },
+    };
+}
+function getFormatLabel(formatType) {
+    const labels = {
+        image: 'image',
+        video: 'video',
+        audio: 'audio',
+        file: 'file',
+    };
+    return labels[formatType] || 'file';
+}
+export function createBinaryContentInjectionMiddleware(_settings, _gthConfig) {
+    debugLog('Creating binary content injection middleware');
+    return Promise.resolve(createMiddleware({
+        name: 'binary-content-injection',
+        // Before next model call, detect and inject HumanMessage with binary content
+        beforeModel: async (state) => {
+            const messages = state.messages || [];
+            // Find recent ToolMessages from gth_read_binary
+            const binaryMessages = [];
+            // Check last few messages (usually just need to check the most recent)
+            for (let i = messages.length - 1; i >= Math.max(0, messages.length - 5); i--) {
+                const msg = messages[i];
+                if (msg instanceof ToolMessage &&
+                    msg.name === 'gth_read_binary' &&
+                    typeof msg.content === 'string') {
+                    const parsedContent = parseBinaryContent(msg.content);
+                    if (parsedContent) {
+                        binaryMessages.push({ message: msg, binaryData: parsedContent });
+                    }
+                }
+            }
+            // If we found binary content, inject HumanMessage(s)
+            if (binaryMessages.length > 0) {
+                debugLog(`Injecting ${binaryMessages.length} HumanMessage(s) with binary content`);
+                const newMessages = [...messages];
+                for (const { binaryData } of binaryMessages) {
+                    const formatLabel = getFormatLabel(binaryData.formatType);
+                    const contentBlock = createContentBlock(binaryData);
+                    const humanMessage = new HumanMessage({
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Here is the ${formatLabel} content from the file:`,
+                            },
+                            contentBlock,
+                        ],
+                    });
+                    newMessages.push(humanMessage);
+                }
+                // Return the modified state with new messages
+                return {
+                    messages: newMessages,
+                };
+            }
+            // No binary content, pass through
+            return undefined;
+        },
+    }));
+}
+//# sourceMappingURL=binaryContentInjectionMiddleware.js.map

package/dist/middleware/binaryContentInjectionMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binaryContentInjectionMiddleware.js","sourceRoot":"","sources":["../../src/middleware/binaryContentInjectionMiddleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,gBAAgB,EAAwB,MAAM,WAAW,CAAC;AACnE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAcrE;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAEnD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8BAA8B;QAC9B,MAAM,WAAW,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAErD,OAAO;YACL,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;YACxB,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;YACxB,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;SACrB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,UAA+B;IACzD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;IAEpD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE,UAAU;QACrB,IAAI;QACJ,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;SACzC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACxC,MAAM,MAAM,GAA2B;QACrC,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;KACb,CAAC;IACF,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,SAAmD,EACnD,UAAqB;IAErB,QAAQ,CAAC,8CAA8C,CAAC,CAAC;IAEzD,OAAO,OAAO,CAAC,OAAO,CACpB,gBAAgB,CAAC;QACf,IAAI,EAAE,0BAA0B;QAEhC,6EAA6E;QAC7E,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;YAEtC,gDAAgD;YAChD,MAAM,cAAc,GAAqE,EAAE,CAAC;YAE5F,uEAAuE;YACvE,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7E,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACxB,IACE,GAAG,YAAY,WAAW;oBAC1B,GAAG,CAAC,IAAI,KAAK,iBAAiB;oBAC9B,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAC/B,CAAC;oBACD,MAAM,aAAa,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACtD,IAAI,aAAa,EAAE,CAAC;wBAClB,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;YACH,CAAC;YAED,qDAAqD;YACrD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,aAAa,cAAc,CAAC,MAAM,sCAAsC,CAAC,CAAC;gBAEnF,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;gBAElC,KAAK,MAAM,EAAE,UAAU,EAAE,IAAI,cAAc,EAAE,CAAC;oBAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;oBAC1D,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;oBAEpD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;wBACpC,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,eAAe,WAAW,yBAAyB;6BAC1D;4BACD,YAAY;yBACK;qBACpB,CAAC,CAAC;oBAEH,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACjC,CAAC;gBAED,8CAA8C;gBAC9C,OAAO;oBACL,QAAQ,EAAE,WAAW;iBACtB,CAAC;YACJ,CAAC;YAED,kCAAkC;YAClC,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/middleware/registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @packageDocumentation
+ * Middleware registry for Gaunt Sloth Assistant.
+ *
+ * This module provides factory functions for creating predefined middleware instances
+ * and a resolver to convert middleware configurations into middleware objects.
+ */
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+import type { AnthropicPromptCachingConfig, MiddlewareConfig, SummarizationConfig } from '#src/middleware/types.js';
+import { type AgentMiddleware } from 'langchain';
+/**
+ * Create Anthropic prompt caching middleware.
+ * This middleware adds cache control headers to reduce API costs.
+ */
+export declare function createAnthropicPromptCachingMiddleware(config: AnthropicPromptCachingConfig, _: GthConfig): Promise<AgentMiddleware>;
+/**
+ * Create summarization middleware.
+ * This middleware automatically condenses conversation history when approaching token limits.
+ *
+ * @param config - Configuration for the middleware
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Middleware object
+ */
+export declare function createSummarizationMiddleware(config: SummarizationConfig, gthConfig: GthConfig): Promise<AgentMiddleware>;
+/**
+ * Resolve middleware configuration into middleware instances.
+ * Converts string identifiers and config objects into actual middleware.
+ * Automatically injects binary-content-injection middleware if binaryFormats is enabled.
+ *
+ * @param configs - Array of middleware configurations
+ * @param gthConfig - Full Gaunt Sloth configuration
+ * @returns Array of middleware instances
+ */
+export declare function resolveMiddleware(configs: MiddlewareConfig[] | undefined, gthConfig: GthConfig): Promise<AgentMiddleware[]>;