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

package/README.md

@@ -1,7 +1,16 @@
-# @gaunt-sloth/agent — placeholder (0.1.8)
+# @gaunt-sloth/agent
 
-This is a **name-reservation placeholder**, not the real package.
+The deep-agent runtime for Gaunt Sloth. Consolidates what were previously
+`@gaunt-sloth/tools` and `@gaunt-sloth/api`:
 
-The real **Deep agent runtime for Gaunt Sloth** (tools, middleware, MCP/A2A clients, AG-UI
-server) ships from the [gaunt-sloth monorepo](https://github.com/Galvanized-Pukeko/gaunt-sloth/tree/main/packages/agent)
-via the `release.yml` pipeline, starting at `2.0.0-alpha.0`.
+- Built-in tools and toolkits (filesystem, dev, custom, web fetch, status update)
+- Middleware registry (summarization, prompt caching, binary content injection)
+- MCP client + OAuth provider
+- A2A client and tools
+- The AG-UI server (`startAgUiServer`) and interactive session module
+- The `createResolvers` tool/middleware resolver wiring
+
+It builds on `@gaunt-sloth/core` (config, provider factory, lean langchain runtime).
+
+> `@gaunt-sloth/tools` and `@gaunt-sloth/api` are deprecated and now re-export
+> from this package.

package/cli-acp.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+/**
+ * ACP (Agent Client Protocol) server entry for the Gaunt Sloth deep agent.
+ * Usage: gaunt-sloth-acp
+ *
+ * Speaks ACP JSON-RPC over stdio, so an ACP host (Zed, JetBrains, a future Pukeko client)
+ * can spawn this binary as a coding agent subprocess.
+ *
+ * stdout is the ACP protocol channel and must stay clean: any stray byte corrupts framing.
+ * gsloth's console output (initConfig info, agent status) routes through console.log/info,
+ * which write to stdout — so before doing anything we redirect those to stderr. The ACP SDK
+ * writes the protocol via process.stdout.write directly and is unaffected; console.warn/error
+ * already go to stderr.
+ */
+
+for (const method of ['log', 'info']) {
+  console[method] = (...args) => process.stderr.write(args.join(' ') + '\n');
+}
+
+import { initConfig } from '@gaunt-sloth/core/config.js';
+import { displayError } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { startAcpServer } from '#src/modules/acpModule.js';
+
+async function main() {
+  try {
+    const config = await initConfig({});
+    await startAcpServer(config);
+  } catch (err) {
+    displayError(`ACP server failed: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+}
+
+main();

package/cli.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+/**
+ * Simple CLI for gaunt-sloth-api
+ * Usage: gaunt-sloth-api [api-type]
+ *
+ * Starts an API server. Currently supports 'ag-ui' type.
+ */
+
+import { initConfig } from '@gaunt-sloth/core/config.js';
+import { startAgUiServer } from '#src/modules/apiAgUiModule.js';
+import { displayError, displayInfo } from '@gaunt-sloth/core/utils/consoleUtils.js';
+
+const args = process.argv.slice(2);
+const apiType = args[0] || 'ag-ui';
+
+async function main() {
+  try {
+    const config = await initConfig({});
+    const port = config.commands?.api?.port ?? 3000;
+
+    if (apiType === 'ag-ui') {
+      displayInfo('Starting AG-UI API server...');
+      await startAgUiServer(config, port);
+    } else {
+      displayError(`Unknown API type: ${apiType}. Supported types: ag-ui`);
+      process.exit(1);
+    }
+  } catch (err) {
+    displayError(`Error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+}
+
+main();

package/dist/builtInToolsConfig.d.ts

@@ -0,0 +1,26 @@
+import { StructuredToolInterface } from '@langchain/core/tools';
+import { GthConfig } from '@gaunt-sloth/core/config.js';
+import { GthCommand } from '@gaunt-sloth/core/core/types.js';
+/**
+ * Available built-in tools may be configured in JSON config, see `builtInTools` of {@link GthConfig}.
+ *
+ * Does not include `filesystem`, because filesystem has its own config in {@link GthConfig}.
+ */
+export declare const AVAILABLE_BUILT_IN_TOOLS: {
+    /**
+     * Reference tool. Simply prints provided argument to the screen.
+     */
+    readonly gth_status_update: "#src/tools/gthStatusUpdateTool.js";
+    /**
+     * Web fetch tool.
+     */
+    readonly gth_web_fetch: "#src/tools/gthWebFetchTool.js";
+    /**
+     * AG-UI A2UI surface tool: lets the agent render an A2UI surface in the web client.
+     */
+    readonly show_a2ui_surface: "#src/tools/showA2UISurfaceTool.js";
+};
+/**
+ * Get default tools based on filesystem and built-in tools configuration
+ */
+export declare function getDefaultTools(config: GthConfig, command?: GthCommand): Promise<StructuredToolInterface[]>;

package/dist/builtInToolsConfig.js

@@ -0,0 +1,148 @@
+/**
+ * @packageDocumentation
+ * Built-in tools config. {@link AVAILABLE_BUILT_IN_TOOLS} has a list of available tools.
+ */
+import GthFileSystemToolkit from '#src/tools/GthFileSystemToolkit.js';
+import { displayWarning } from '@gaunt-sloth/core/utils/consoleUtils.js';
+import { getCurrentWorkDir } from '@gaunt-sloth/core/utils/systemUtils.js';
+import GthDevToolkit from '#src/tools/GthDevToolkit.js';
+import GthCustomToolkit from '#src/tools/GthCustomToolkit.js';
+/**
+ * Available built-in tools may be configured in JSON config, see `builtInTools` of {@link GthConfig}.
+ *
+ * Does not include `filesystem`, because filesystem has its own config in {@link GthConfig}.
+ */
+export const AVAILABLE_BUILT_IN_TOOLS = {
+    /**
+     * Reference tool. Simply prints provided argument to the screen.
+     */
+    gth_status_update: '#src/tools/gthStatusUpdateTool.js',
+    /**
+     * Web fetch tool.
+     */
+    gth_web_fetch: '#src/tools/gthWebFetchTool.js',
+    /**
+     * AG-UI A2UI surface tool: lets the agent render an A2UI surface in the web client.
+     */
+    show_a2ui_surface: '#src/tools/showA2UISurfaceTool.js',
+};
+/**
+ * Get default tools based on filesystem and built-in tools configuration
+ */
+export async function getDefaultTools(config, command) {
+    const filesystemTools = filterFilesystemTools(config.filesystem, config.aiignore, config.binaryFormats);
+    const builtInTools = await getBuiltInTools(config);
+    // Dev tools (run commands etc.) are available to the interactive `code` command and to the
+    // scripted `exec` command — both are "do-the-job" runs — each via its own per-command config.
+    // `ask --write` (config.askWriteMode) opts `ask` into the same do-the-job tools, reusing the
+    // devTools config the --write flag copied onto commands.ask.
+    const askWrite = command === 'ask' && config.askWriteMode === true;
+    const devToolConfig = command === 'exec'
+        ? config.commands?.exec?.devTools
+        : askWrite
+            ? config.commands?.ask?.devTools
+            : config.commands?.code?.devTools;
+    const devTools = await filterDevTools(askWrite ? 'code' : command, devToolConfig);
+    const customTools = getCustomTools(config, command);
+    return [...filesystemTools, ...devTools, ...customTools, ...builtInTools];
+}
+async function filterDevTools(command, devToolConfig) {
+    if ((command !== 'code' && command !== 'exec') || !devToolConfig) {
+        return [];
+    }
+    const toolkit = new GthDevToolkit(devToolConfig);
+    return [...toolkit.getTools()];
+}
+/**
+ * Get custom tools based on configuration.
+ * Supports global customTools and per-command overrides.
+ */
+function getCustomTools(config, command) {
+    // Determine which custom tools to use
+    let toolsConfig;
+    if (command && config.commands?.[command]) {
+        const cmdConfig = config.commands[command];
+        // Check if command has customTools override
+        if ('customTools' in cmdConfig) {
+            toolsConfig = cmdConfig.customTools;
+        }
+        else {
+            // No override, use root-level
+            toolsConfig = config.customTools;
+        }
+    }
+    else {
+        // No command specified or no command config, use root-level
+        toolsConfig = config.customTools;
+    }
+    // If explicitly disabled or empty, return no tools
+    if (toolsConfig === false || !toolsConfig || Object.keys(toolsConfig).length === 0) {
+        return [];
+    }
+    // Create toolkit with the determined config
+    const toolkit = new GthCustomToolkit(toolsConfig);
+    return toolkit.getTools();
+}
+/**
+ * Filter filesystem tools based on configuration
+ */
+function filterFilesystemTools(filesystemConfig, aiignoreConfig, binaryFormats) {
+    const toolkit = new GthFileSystemToolkit({
+        allowedDirectories: [getCurrentWorkDir()],
+        aiignoreConfig,
+        binaryFormats,
+    });
+    if (filesystemConfig === 'all') {
+        return toolkit.getTools();
+    }
+    if (filesystemConfig === 'none') {
+        return [];
+    }
+    if (filesystemConfig === 'read') {
+        // Read-only: only allow read operations
+        return toolkit.getFilteredTools(['read']);
+    }
+    if (!Array.isArray(filesystemConfig)) {
+        return toolkit.getTools();
+    }
+    if (filesystemConfig.includes('all')) {
+        return toolkit.getTools();
+    }
+    // Handle an array of specific tool names or 'read'/'all'
+    const allowedTools = filesystemConfig.includes('read')
+        ? toolkit.getFilteredTools(['read'])
+        : [];
+    // Also allow specific tool names
+    const allowedToolNames = new Set(filesystemConfig.filter((name) => name !== 'read' && name !== 'all'));
+    const specificNamedTools = toolkit.getTools().filter((tool) => {
+        return tool.name && allowedToolNames.has(tool.name);
+    });
+    // Combine and deduplicate
+    const allAllowedTools = [...allowedTools, ...specificNamedTools];
+    return allAllowedTools.filter((tool, index, arr) => arr.findIndex((t) => t.name === tool.name) === index);
+}
+/**
+ * Get built-in tools based on configuration
+ */
+async function getBuiltInTools(config) {
+    const tools = [];
+    if (!config.builtInTools) {
+        return tools;
+    }
+    for (const toolName of config.builtInTools) {
+        if (toolName in AVAILABLE_BUILT_IN_TOOLS) {
+            try {
+                const tool = await import(AVAILABLE_BUILT_IN_TOOLS[toolName]);
+                tools.push(tool.get(config));
+            }
+            catch (error) {
+                displayWarning(`Failed to load built-in tool '${toolName}': ${error}`);
+            }
+        }
+        else {
+            displayWarning(`Unknown built-in tool: ${toolName}`);
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=builtInToolsConfig.js.map

package/dist/builtInToolsConfig.js.map

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

package/dist/core/GthDeepAgent.d.ts

@@ -0,0 +1,76 @@
+import type { GthConfig } from '@gaunt-sloth/core/config.js';
+import { GthAbstractAgent } from '@gaunt-sloth/core/core/GthAbstractAgent.js';
+import { type GthCommand } from '@gaunt-sloth/core/core/types.js';
+import type { StructuredToolInterface } from '@langchain/core/tools';
+import type { BaseCheckpointSaver } from '@langchain/langgraph';
+import { type FilesystemPermission } from '#src/core/deepAgentPermissions.js';
+import type { DebugCapture, DebugRequestExtras } from '#src/core/debugCapture.js';
+/**
+ * The subset of `createDeepAgent` params that are independent of the transport
+ * (the local runner vs. the ACP server). Both {@link GthDeepAgent.init} (which adds the
+ * console-bound tool-call-status middleware + a virtual {@link FilesystemBackend} +
+ * checkpointer and calls `createDeepAgent`) and the ACP entry (deepagents-acp
+ * `startServer`, which supplies its own ACP-proxying backend, checkpointer and tool-call
+ * reporting) consume these.
+ *
+ * `middleware` here deliberately EXCLUDES the tool-call-status middleware: that one writes
+ * to stdout, which on the ACP path is the JSON-RPC channel and must stay clean. The runner
+ * path appends it in {@link GthDeepAgent.init}.
+ */
+export interface GthDeepAgentParams {
+    model: any;
+    tools: StructuredToolInterface[];
+    permissions: FilesystemPermission[];
+    middleware: any[];
+    /**
+     * gsloth's composed system prompt (backstory + guidelines + per-command mode prompt +
+     * system prompt). Passed to `createDeepAgent({ systemPrompt })`, where deepagents combines
+     * it ADDITIVELY with its own base + filesystem prompts into ONE system message. This replaces
+     * the previous per-turn `SystemMessage` injection by the runner/AG-UI callers — two system
+     * messages (deepagents' own + gsloth's, not first) are rejected by Anthropic. `undefined` when
+     * no prompt content is composed (lets deepagents use only its base prompt).
+     */
+    systemPrompt: string | undefined;
+}
+/**
+ * Deep agent: builds a `createDeepAgent` graph (deepagents). All run/stream/event
+ * plumbing lives in {@link GthAbstractAgent}; this class only knows how to construct
+ * the graph in {@link init}.
+ *
+ * Differences from the lean {@link GthLangChainAgent}:
+ * - deepagents provides the filesystem tools (`read_file`/`write_file`/`edit_file`/
+ *   `ls`/`glob`/`grep`/`execute`) via its own middleware, backed by a
+ *   {@link FilesystemBackend}. gsloth's `.aiignore` + `filesystem` config are mapped
+ *   onto deepagents `permissions` (see {@link buildPermissions}). Any resolved tool
+ *   that reuses a deepagents filesystem-tool name is therefore superseded and dropped
+ *   (`createDeepAgent` would otherwise throw on the collision).
+ * - todos / subagents / summarization come from deepagents' standard middleware.
+ *
+ * The transport-agnostic param assembly lives in {@link buildDeepAgentParams} so the ACP
+ * entry (`deepagents-acp`) can reuse the exact same tool resolution, permission mapping and
+ * middleware hardening without re-running `createDeepAgent` locally.
+ */
+export declare class GthDeepAgent extends GthAbstractAgent {
+    /**
+     * Opt-in debug sink for the TUI `/debug` panel. Set AFTER {@link init} via
+     * `runner.getAgent()`; read lazily inside the `wrapModelCall` middleware so that when it
+     * is `undefined` (the normal path) the middleware is a transparent pass-through. Never
+     * touched by the lean agent or the AG-UI server, so those contracts are unchanged.
+     */
+    debugCapture: DebugCapture | undefined;
+    init(command: GthCommand | undefined, configIn: GthConfig, checkpointer?: BaseCheckpointSaver | undefined): Promise<void>;
+    /**
+     * Assemble the transport-agnostic {@link GthDeepAgentParams}: resolve tools (with the
+     * filesystem disabled so deepagents owns fs access), apply the allowedTools allow-list and
+     * the deepagents fs-name supersession safety-net, map `.aiignore` + filesystem mode onto
+     * deepagents permissions, and build the fs-denial-softening middleware. Shared by the local
+     * runner ({@link init}) and the `deepagents-acp` ACP entry.
+     */
+    buildDeepAgentParams(command: GthCommand | undefined, configIn: GthConfig): Promise<GthDeepAgentParams>;
+}
+/**
+ * Assemble the non-message request parts ({@link DebugRequestExtras}) for the `/debug`
+ * panel from a `wrapModelCall` request, defensively and key-free. Never throws (the caller
+ * already guards, but a debug sink must never break a run) and never dumps the raw model.
+ */
+export declare function extractDebugRequestExtras(request: unknown): DebugRequestExtras | undefined;