ikarmic-forge 0.0.0-stage → 4.5.0

package/dist/repl.d.ts

@@ -0,0 +1,76 @@
+import React from 'react';
+import type { ModelMessage } from 'ai';
+import { type AgentConfig, type ForgeConfigFile, type ModelConfig } from '@ikarmic/forge-core';
+import type { Notifier } from './notify.js';
+import { copyToClipboard, readClipboard } from './clipboard.js';
+import { type EditorResult } from './repl-extras.js';
+import type { GitWorkflow } from './git-workflow.js';
+/**
+ * Persistent interactive REPL: multi-turn chat with the agent.
+ *
+ * Each turn:
+ *   1. User types a task, presses Enter.
+ *   2. We append a user message to history.
+ *   3. We run `new Agent(config).run({ task, history })`.
+ *   4. We stream events into the visible transcript.
+ *   5. After completion, we append the agent's new messages to history.
+ *   6. Repeat.
+ *
+ * The conversation history is what enables multi-turn context: every tool
+ * result the agent saw is preserved across turns.
+ */
+export interface PageFetch {
+    url: string;
+    title?: string;
+    status: number;
+    excerpt: string;
+    truncated: boolean;
+}
+export interface ReplServices {
+    copy?: typeof copyToClipboard;
+    read?: typeof readClipboard;
+    /** Open the user's editor on `initial` and return what they wrote. */
+    edit?: (initial: string) => Promise<EditorResult>;
+    fetchPage?: (url: string, cwd: string) => Promise<PageFetch>;
+}
+export interface ReplProps {
+    baseConfig: AgentConfig;
+    model: ModelConfig;
+    onExit: () => void;
+    /**
+     * Either a fresh session id (start a new session) or an existing id
+     * (resume from `~/.forge/sessions/<id>.json`). Either way, the REPL
+     * auto-saves after every turn so the user can pick up where they left off.
+     */
+    sessionId: string;
+    /** Pre-loaded history, if resuming. */
+    initialHistory?: ModelMessage[];
+    /** Initial label, if any. */
+    initialLabel?: string;
+    /** Where to persist sessions. */
+    sessionDir: string;
+    display?: ForgeConfigFile['display'];
+    /** `--auto-commit` workflow; null/absent when off. */
+    gitWorkflow?: GitWorkflow | null;
+    /** Commit options (attribution, hooks) used by `/commit`. */
+    gitOptions?: {
+        noAttribute: boolean;
+        gitCommitVerify: boolean;
+    };
+    /** Called when a turn finishes (`--notifications`). */
+    notify?: Notifier;
+    /** Model that drafts commit messages for `/commit`. */
+    commitModel?: ModelConfig;
+    /** `aliases` from ~/.forge/config.json, for `/model` and `/models`. */
+    aliases?: Record<string, string>;
+    /** Forge's version, for `/report`. */
+    version?: string;
+    /** Replaceable system access (clipboard, editor, web), for tests. */
+    services?: ReplServices;
+    /** `--lint-cmd` commands: what `/lint` runs with no argument. */
+    lintCmds?: string[];
+    /** `--test-cmd` commands: what `/test` runs with no argument. */
+    testCmds?: string[];
+}
+export declare function Repl({ baseConfig, model: initialModel, onExit, sessionId, initialHistory, initialLabel, sessionDir, display, gitWorkflow, gitOptions, commitModel, notify, aliases, version, services, lintCmds, testCmds, }: ReplProps): React.ReactElement;
+//# sourceMappingURL=repl.d.ts.map

package/dist/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../src/repl.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAIjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAEvC,OAAO,EAEL,KAAK,WAAW,EAKhB,KAAK,eAAe,EACpB,KAAK,WAAW,EAgBjB,MAAM,qBAAqB,CAAC;AAiB7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAML,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAkB1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,eAAe,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,aAAa,CAAC;IAC5B,sEAAsE;IACtE,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC9D;AA+BD,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,WAAW,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACrC,sDAAsD;IACtD,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,UAAU,CAAC,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;IAChE,uDAAuD;IACvD,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,uDAAuD;IACvD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAuBD,wBAAgB,IAAI,CAAC,EACnB,UAAU,EACV,KAAK,EAAE,YAAY,EACnB,MAAM,EACN,SAAS,EACT,cAAc,EACd,YAAY,EACZ,UAAU,EACV,OAAY,EACZ,WAAkB,EAClB,UAA2D,EAC3D,WAAW,EACX,MAAM,EACN,OAAO,EACP,OAAmB,EACnB,QAAQ,EACR,QAAa,EACb,QAAa,GACd,EAAE,SAAS,GAAG,KAAK,CAAC,YAAY,CA04ChC"}