@gaunt-sloth/core 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/constants.js

@@ -4,6 +4,7 @@ export const GSLOTH_AUTH = '.gsloth-auth';
 export const USER_PROJECT_CONFIG_JS = '.gsloth.config.js';
 export const USER_PROJECT_CONFIG_JSON = '.gsloth.config.json';
 export const USER_PROJECT_CONFIG_MJS = '.gsloth.config.mjs';
+export const USER_PROJECT_CONFIG_TS = '.gsloth.config.ts';
 export const GSLOTH_BACKSTORY = '.gsloth.backstory.md';
 export const PROJECT_GUIDELINES = '.gsloth.guidelines.md';
 export const PROJECT_REVIEW_INSTRUCTIONS = '.gsloth.review.md';
@@ -12,4 +13,45 @@ export const GSLOTH_CHAT_PROMPT = '.gsloth.chat.md';
 export const GSLOTH_CODE_PROMPT = '.gsloth.code.md';
 export const GSLOTH_EXEC_PROMPT = '.gsloth.exec.md';
 export const AIIGNORE_FILE = '.aiignore';
+/**
+ * `$schema` pointer written into a generated `.gsloth.config.json` (GS2-1) so editors offer
+ * autocomplete + validation. The **hosted, major-pinned** URL is used rather than a relative
+ * `node_modules` path because the relative path only resolves when `@gaunt-sloth/core` sits in a
+ * `node_modules` beside the config, which is NOT the case for a globally-installed CLI
+ * (`npm i -g`): the schema lands in the global prefix, not next to the user's project config, so
+ * a relative pointer would silently fail to resolve. A hosted URL resolves for every install mode
+ * (global, npx, local, or a hand-written config with nothing installed) and is the standard
+ * convention editors fetch + cache.
+ *
+ * The channel is **major-pinned** (`/schema/v2/…`, not `latest` or `alpha`) so a config never
+ * revalidates against a future major it was not written for. The hosted copy is kept in sync with
+ * this package's generated schema by the deploy runbook in
+ * `websites/gauntsloth-site/schema/README.md` (interim, hand-run) and, in time, PLAT-9's automated
+ * release step. The schema still ships inside the package (`files: ["./schema/*"]`) as an offline
+ * artifact and golden-snapshot source of truth; it is just no longer what the pointer references.
+ */
+export const CONFIG_SCHEMA_POINTER = 'https://gauntsloth.app/schema/v2/gsloth-config.schema.json';
+/**
+ * EXT-9 Tier-2: project-scoped persisted shell allow-list (`always` approvals).
+ * Lives under `.gsloth/.gsloth-settings/` like other project settings.
+ */
+export const SHELL_ALLOWLIST_FILE = 'shell-allowlist.json';
+/**
+ * The `additionalToolNamePrefix` handed to `MultiServerMCPClient` so every MCP tool name is
+ * namespaced. Combined with `prefixToolNameWithServerName`, the adapter emits tool names shaped
+ * `${MCP_TOOL_NAME_PREFIX}__<serverName>__<toolName>` (the `__` separator is the mcp-adapters
+ * convention). Single-sourced here so the resolver that sets the prefix (EXT-32) and any consumer
+ * that groups tools back by server (the [[TUI-C20]] MCP debug tab) can never silently drift apart.
+ */
+export const MCP_TOOL_NAME_PREFIX = 'mcp';
+/**
+ * GS2-35 — the canonical Git co-author identity for agent-authored commits. When Gaunt Sloth writes
+ * a commit (via `run_shell_command` `git commit`) the co-author is *Gaunt Sloth itself*, NOT the
+ * underlying model — attributing the commit to the model name (e.g. `Claude`, `GPT`) is factually
+ * wrong. Config (`commit.coAuthor`) overrides this; single-sourced so the config default and the
+ * prompt-guidance fallback ({@link import('#src/utils/systemPromptNotes.js').appendCommitCoAuthorNote})
+ * can never drift.
+ */
+export const DEFAULT_COMMIT_CO_AUTHOR_NAME = 'Gaunt Sloth';
+export const DEFAULT_COMMIT_CO_AUTHOR_EMAIL = 'code@gauntsloth.app';
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAC9D,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,4DAA4D,CAAC;AAClG;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,aAAa,CAAC;AAC3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,qBAAqB,CAAC"}

package/dist/core/GthAbstractAgent.d.ts

@@ -1,10 +1,29 @@
 import { GthConfig, ServerTool } from '#src/config.js';
-import { AgentResolvers, AgentStreamEvent, GthAgentInterface, GthCommand, GthCompiledGraph, Message, StatusUpdateCallback } from '#src/core/types.js';
-import { BaseMessage } from '@langchain/core/messages';
+import { AgentResolvers, AgentStreamEvent, GthAgentInterface, GthCommand, GthCompiledGraph, GthRunStats, Message, PendingToolInterrupt, StatusUpdateCallback } from '#src/core/types.js';
+import type { DebugCapture } from '#src/core/debugCapture.js';
+import { AIMessageChunk, BaseMessage } from '@langchain/core/messages';
 import { RunnableConfig } from '@langchain/core/runnables';
 import { BaseToolkit, StructuredToolInterface } from '@langchain/core/tools';
 import { IterableReadableStream } from '@langchain/core/utils/stream';
 import { BaseCheckpointSaver } from '@langchain/langgraph';
+/**
+ * TUI-C29 — return a chunk fit for `concat`-aggregation with OpenRouter's raw response stripped.
+ *
+ * The openrouter provider enables `__includeRawResponse` (TUI-C22), which stashes the *full* raw
+ * provider response under `additional_kwargs.__raw_response` so {@link pickReasoningDelta} can lift
+ * a top-level `reasoning` delta the ChatOpenAI converter otherwise drops. Reasoning is only ever
+ * read off the **per-chunk** `additional_kwargs`, never off the aggregate — yet `AIMessageChunk.concat`
+ * deep-merges `additional_kwargs` (`_mergeDicts`), so leaving `__raw_response` on the chunk makes the
+ * aggregate accumulate a linearly-growing, unused copy of it for the whole stream.
+ *
+ * Strip it on a **shallow clone** so the ORIGINAL chunk the reasoning path reads (line ~697) stays
+ * untouched (approach A — no mutation of the stream-owned object). The clone preserves the chunk's
+ * prototype (so it keeps a working `.concat` when it becomes the first aggregate) and every field
+ * `concat` reads (content, tool_call_chunks, tool_calls, response_metadata, usage_metadata, id),
+ * overriding only `additional_kwargs`. When the key is absent (every non-OpenRouter provider) the
+ * chunk is returned as-is, so those paths are byte-for-byte unchanged.
+ */
+export declare function stripRawResponseForAggregation(chunk: AIMessageChunk): AIMessageChunk;
 /**
  * Shared, graph-agnostic agent plumbing.
  *
@@ -24,7 +43,48 @@ export declare abstract class GthAbstractAgent implements GthAgentInterface {
     protected agent: GthCompiledGraph | null;
     protected config: GthConfig | null;
     protected command: GthCommand | undefined;
+    /**
+     * Opt-in debug sink for the TUI `/debug` panel. Set AFTER {@link init} via
+     * `runner.getAgent()`; read lazily inside each backend's `wrapModelCall` capture middleware
+     * so that when it is `undefined` (the normal path) the middleware is a transparent
+     * pass-through. Lives on the base so BOTH the lean and deep backends support it; the AG-UI
+     * server / non-TUI callers simply never set it, so those contracts are unchanged.
+     */
+    debugCapture: DebugCapture | undefined;
+    /**
+     * GS2-16 — per-run analytics tally (token usage + invoked tool names) folded from the messages
+     * flowing through {@link invoke} / the streaming paths. Reset at each turn boundary via
+     * {@link resetRunStats} (the runner is reused across turns), read via {@link getRunStats}, and
+     * fully fail-soft (accumulation is guarded and never throws into a run).
+     */
+    private runStatsAcc;
     constructor(statusUpdate: StatusUpdateCallback, resolvers?: AgentResolvers);
+    /**
+     * GS2-63 — emit one line of the technical run-header preamble (the Workdir/Model/Tools/Middleware
+     * block) UNLESS it is opted out via `output.header: false`. The opt-out only ever reaches here in
+     * non-TUI text modes: the interactive TUI forces `output.header` on before init (see
+     * `createTuiSession`), and the TUI event path never goes through the interrupt-hint site, so the
+     * whole preamble stays visible there. Only INFO header lines route through this — real model/tool
+     * output, warnings and errors keep using {@link statusUpdate} directly.
+     */
+    protected headerStatus(message: string): void;
+    /**
+     * GS2-16 — clear the per-run analytics tally so the next turn starts from zero. The runner
+     * calls this at each turn boundary because it (and this agent) are reused across turns in an
+     * interactive session.
+     */
+    resetRunStats(): void;
+    /** GS2-16 — the analytics harvested since the last {@link resetRunStats}. Never throws. */
+    getRunStats(): GthRunStats;
+    /** GS2-16 — fold one message (or chunk) into the run tally. Fully guarded (fail-soft). */
+    protected recordRunStats(message: unknown): void;
+    /**
+     * GS2-16 — best-effort count of messages already in the checkpointed thread state, used by
+     * {@link invoke} as the baseline so it harvests only THIS turn's new messages rather than the
+     * whole accumulated conversation a checkpointer returns. Fail-soft: a missing `getState`, an odd
+     * state shape, or any error yields 0 (worst case a one-turn over-count, never a throw).
+     */
+    private getStateMessageCount;
     /**
      * Build the underlying compiled graph and assign it to {@link agent}. This is the only
      * part that differs between the lean and deep agents.
@@ -42,6 +102,19 @@ export declare abstract class GthAbstractAgent implements GthAgentInterface {
      * When stream is not appropriate use {@link invoke}.
      */
     stream(messages: Message[], runConfig: RunnableConfig): Promise<IterableReadableStream<string>>;
+    /**
+     * Resume a graph suspended on a human-in-the-loop `interrupt()` and stream the continuation
+     * as text. Identical plumbing to {@link stream} (Esc-to-interrupt, binary handling), except
+     * the graph input is a `Command({ resume })` instead of fresh `messages` — so the suspended
+     * tool-approval interrupt is answered and the run continues on the same thread.
+     */
+    streamResume(resumeValue: unknown, runConfig: RunnableConfig): Promise<IterableReadableStream<string>>;
+    /**
+     * Shared body for {@link stream} / {@link streamResume}: drive the compiled graph from
+     * `input` (fresh `{ messages }` or a resume `Command`) and surface AI text deltas as a
+     * string stream, with Esc-to-interrupt and binary-output materialization.
+     */
+    private streamFromInput;
     /**
      * Stream agent events as typed AgentStreamEvent objects.
      * Yields text deltas, tool call lifecycle events, and tool results.
@@ -61,6 +134,16 @@ export declare abstract class GthAbstractAgent implements GthAgentInterface {
      * the client sends in `forwardedProps.command.resume`.
      */
     streamWithEventsResume(resumeValue: unknown, runConfig: RunnableConfig, queuedMessages?: BaseMessage[], signal?: AbortSignal): AsyncGenerator<AgentStreamEvent>;
+    /**
+     * Inspect the checkpointed state for the thread and return the tool calls currently pending
+     * human approval (empty array when the run finished normally). A LangGraph
+     * `humanInTheLoopMiddleware` interrupt parks one `HITLRequest` per suspended super-step in
+     * `state.tasks[].interrupts[].value.actionRequests` (each `{ name, args }`); this flattens
+     * those into {@link PendingToolInterrupt}s. Defensive throughout — a graph without
+     * `getState`, or any unexpected shape, yields `[]` rather than throwing, so a missing HITL
+     * setup degrades to "no approval needed" instead of breaking the run.
+     */
+    getPendingToolInterrupts(runConfig: RunnableConfig): Promise<PendingToolInterrupt[]>;
     protected processEventStream(stream: IterableReadableStream<[BaseMessage, Record<string, unknown>]>): AsyncGenerator<AgentStreamEvent>;
     cleanup(): Promise<void>;
     getEffectiveConfig(config: GthConfig, command: GthCommand | undefined): GthConfig;