@gencode/agents 0.0.3 → 0.0.5

package/dist/runner/invocation-resolver.js

@@ -0,0 +1,224 @@
+import { handleSlashCommand, parseResetCommand } from "../commands/index.js";
+import { compactTranscriptNow } from "../commands/compact.js";
+import { handleNewCommand } from "../commands/new.js";
+import { handleResetCommand } from "../commands/reset.js";
+import { loadTranscript } from "../session/session.js";
+import { finalizeShortCircuitRun } from "./finalizer.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+export function prepareInvocation(params) {
+    const inputMode = isTextRunParams(params) ? "text" : "messages";
+    const rawMessage = inputMode === "text" ? params.message : undefined;
+    const inputMessages = inputMode === "messages" ? params.messages : undefined;
+    const structuredUserText = inputMessages ? extractLeadingUserTextMessage(inputMessages) : null;
+    const slashCommandSource = rawMessage ?? structuredUserText?.text;
+    const resetCommand = slashCommandSource ? parseResetCommand(slashCommandSource) : null;
+    const resetRemainder = resetCommand?.remainder ?? "";
+    const resetShortCircuit = Boolean(resetCommand && !resetRemainder);
+    const messageForRun = resetCommand && resetRemainder ? resetRemainder : slashCommandSource;
+    const promptInput = inputMode === "text"
+        ? (messageForRun ?? "")
+        : (resetCommand && resetRemainder && inputMessages
+            ? replaceLeadingUserTextMessage(inputMessages, resetRemainder)
+            : inputMessages);
+    const transcriptMessage = inputMode === "text"
+        ? (resetShortCircuit ? rawMessage : (messageForRun ?? ""))
+        : serializeUserInput(promptInput);
+    return {
+        inputMode,
+        rawMessage,
+        promptInput,
+        transcriptMessage,
+        slashCommandSource,
+        messageForRun,
+        requestedSessionId: resetCommand ? undefined : params.sessionId,
+        previousSessionId: resetCommand ? params.sessionId : undefined,
+        resetCommand: resetCommand ?? undefined,
+        resetShortCircuit,
+    };
+}
+export function resolveSlashInvocation(invocation, skills) {
+    if (invocation.resetShortCircuit) {
+        return {
+            kind: "reset_reply",
+            action: invocation.resetCommand?.action ?? "new",
+            transcriptMessage: invocation.transcriptMessage,
+            initialUserEntryPersisted: true,
+        };
+    }
+    if (!invocation.slashCommandSource) {
+        return {
+            kind: "run",
+            effectivePrompt: invocation.promptInput,
+            transcriptMessage: invocation.transcriptMessage,
+        };
+    }
+    const slashResult = handleSlashCommand({ message: invocation.messageForRun ?? "", skills });
+    if (slashResult.kind === "reply") {
+        return {
+            kind: "reply",
+            replyText: slashResult.text,
+            transcriptMessage: invocation.transcriptMessage,
+        };
+    }
+    if (slashResult.kind === "compact") {
+        return {
+            kind: "compact",
+            transcriptMessage: invocation.transcriptMessage,
+            instructions: slashResult.instructions,
+            initialUserEntryPersisted: invocation.resetCommand ? true : undefined,
+        };
+    }
+    if (slashResult.kind === "rewrite") {
+        const effectivePrompt = invocation.inputMode === "text"
+            ? slashResult.message
+            : replaceLeadingUserTextMessage(invocation.promptInput, slashResult.message);
+        return {
+            kind: "run",
+            effectivePrompt,
+            transcriptMessage: serializeUserInput(effectivePrompt),
+        };
+    }
+    return {
+        kind: "run",
+        effectivePrompt: invocation.inputMode === "text" ? (invocation.messageForRun ?? "") : invocation.promptInput,
+        transcriptMessage: invocation.inputMode === "text"
+            ? (invocation.messageForRun ?? "")
+            : invocation.transcriptMessage,
+    };
+}
+export async function handleInvocation(params) {
+    const resolvedInvocation = resolveSlashInvocation(params.invocation, params.skills);
+    if (resolvedInvocation.kind === "run") {
+        return {
+            kind: "continue",
+            effectivePrompt: resolvedInvocation.effectivePrompt,
+            transcriptMessage: resolvedInvocation.transcriptMessage,
+        };
+    }
+    if (resolvedInvocation.kind === "reset_reply") {
+        const resetReply = resolvedInvocation.action === "reset" ? handleResetCommand() : handleNewCommand();
+        return {
+            kind: "completed",
+            result: await finalizeShortCircuitRun({
+                replyText: resetReply.text,
+                sessionId: params.sessionId,
+                isNewSession: params.isNewSession,
+                transcriptMessage: resolvedInvocation.transcriptMessage,
+                initialUserEntryPersisted: resolvedInvocation.initialUserEntryPersisted || params.initialUserEntryPersisted,
+                runParams: params.runParams,
+                hookRegistry: params.hookRegistry,
+                hookContext: params.hookContext,
+                startTime: params.startTime,
+                eventDispatcher: params.eventDispatcher,
+            }),
+        };
+    }
+    if (resolvedInvocation.kind === "reply") {
+        return {
+            kind: "completed",
+            result: await finalizeShortCircuitRun({
+                replyText: resolvedInvocation.replyText,
+                sessionId: params.sessionId,
+                isNewSession: params.isNewSession,
+                transcriptMessage: resolvedInvocation.transcriptMessage,
+                initialUserEntryPersisted: resolvedInvocation.initialUserEntryPersisted || params.initialUserEntryPersisted,
+                runParams: params.runParams,
+                hookRegistry: params.hookRegistry,
+                hookContext: params.hookContext,
+                startTime: params.startTime,
+                eventDispatcher: params.eventDispatcher,
+            }),
+        };
+    }
+    const rawHistory = params.runParams.channel === "CRON" ? [] : await loadTranscript(params.runParams.dataDir, params.sessionId);
+    const compactResult = await compactTranscriptNow({
+        entries: rawHistory,
+        contextWindowTokens: params.runParams.llm.contextWindow ?? 200_000,
+        llm: {
+            baseUrl: params.runParams.llm.baseUrl,
+            apiKey: params.runParams.llm.apiKey,
+            model: params.runParams.llm.model,
+        },
+        instructions: resolvedInvocation.instructions,
+        signal: params.runParams.abortSignal,
+        hooks: params.hookRegistry,
+        hookCtx: params.hookContext,
+    });
+    const compactText = compactResult.status === "compacted"
+        ? `⚙️ Compacted (kept ${compactResult.keptCount}, dropped ${compactResult.droppedCount}).`
+        : `⚙️ Compaction skipped: ${compactResult.reason}`;
+    return {
+        kind: "completed",
+        result: await finalizeShortCircuitRun({
+            replyText: compactText,
+            sessionId: params.sessionId,
+            isNewSession: params.isNewSession,
+            transcriptMessage: resolvedInvocation.transcriptMessage,
+            initialUserEntryPersisted: resolvedInvocation.initialUserEntryPersisted || params.initialUserEntryPersisted,
+            runParams: params.runParams,
+            hookRegistry: params.hookRegistry,
+            hookContext: params.hookContext,
+            startTime: params.startTime,
+            compactionEntry: compactResult.status === "compacted" ? compactResult.entry : undefined,
+            eventDispatcher: params.eventDispatcher,
+        }),
+    };
+}
+function isTextRunParams(params) {
+    return typeof params.message === "string";
+}
+function extractLeadingUserTextMessage(messages) {
+    for (let index = 0; index < messages.length; index += 1) {
+        const candidate = messages[index];
+        if (candidate.role !== "user") {
+            continue;
+        }
+        if (typeof candidate.content === "string") {
+            return { index, text: candidate.content };
+        }
+        if (!Array.isArray(candidate.content) || candidate.content.length === 0) {
+            return null;
+        }
+        const firstBlock = candidate.content[0];
+        if (firstBlock?.type === "text" && typeof firstBlock.text === "string") {
+            return { index, text: firstBlock.text };
+        }
+        return null;
+    }
+    return null;
+}
+function replaceLeadingUserTextMessage(messages, replacement) {
+    const match = extractLeadingUserTextMessage(messages);
+    if (!match) {
+        return messages;
+    }
+    return messages.map((message, index) => {
+        if (index !== match.index) {
+            return message;
+        }
+        const candidate = message;
+        if (typeof candidate.content === "string") {
+            return { ...message, content: replacement };
+        }
+        if (Array.isArray(candidate.content) && candidate.content.length > 0) {
+            return {
+                ...message,
+                content: candidate.content.map((block, blockIndex) => {
+                    if (blockIndex !== 0) {
+                        return block;
+                    }
+                    const typedBlock = block;
+                    if (typedBlock?.type === "text" && typeof typedBlock.text === "string") {
+                        return { ...typedBlock, text: replacement };
+                    }
+                    return block;
+                }),
+            };
+        }
+        return message;
+    });
+}
+function serializeUserInput(input) {
+    return typeof input === "string" ? input : JSON.stringify(input);
+}
+//# sourceMappingURL=invocation-resolver.js.map

package/dist/runner/invocation-resolver.js.map

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

package/dist/runner/plugin-context.d.ts

@@ -0,0 +1,18 @@
+import { PluginHookRegistry, type PluginHookAgentContext } from "../plugins/hooks.js";
+import type { AgentRunParams } from "../types.js";
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+export type RunnerPluginContext = {
+    hookRegistry: PluginHookRegistry;
+    pluginSkillDirs: string[];
+    pluginTools: AgentTool[];
+    memoryPluginId?: string;
+};
+/**
+ * Resolves all runner-facing plugin derivatives in one place so the caller
+ * does not need to understand the plugin registry layout.
+ */
+export declare function createRunnerPluginContext(params: {
+    runParams: AgentRunParams;
+    hookContext: PluginHookAgentContext;
+}): RunnerPluginContext;
+//# sourceMappingURL=plugin-context.d.ts.map

package/dist/runner/plugin-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.d.ts","sourceRoot":"","sources":["../../src/runner/plugin-context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,kBAAkB,CAAC;IACjC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,sBAAsB,CAAC;CACrC,GAAG,mBAAmB,CAoBtB"}

package/dist/runner/plugin-context.js

@@ -0,0 +1,26 @@
+import { initializePluginSystem } from "../plugins/manager.js";
+import { PluginHookRegistry } from "../plugins/hooks.js";
+/**
+ * Resolves all runner-facing plugin derivatives in one place so the caller
+ * does not need to understand the plugin registry layout.
+ */
+export function createRunnerPluginContext(params) {
+    const { runParams, hookContext } = params;
+    const pluginSystem = runParams.plugins
+        ? initializePluginSystem({
+            ...runParams.plugins,
+            runtime: {
+                llm: runParams.llm,
+                hookCtx: hookContext,
+                llmAllowlist: runParams.plugins.llmAllowlist,
+            },
+        })
+        : undefined;
+    return {
+        hookRegistry: pluginSystem?.registry.hooks ?? new PluginHookRegistry(),
+        pluginSkillDirs: pluginSystem?.registry.skills ?? [],
+        pluginTools: pluginSystem?.registry.tools.resolveEnabled(runParams.plugins?.toolAllowlist) ?? [],
+        memoryPluginId: runParams.memory?.pluginId ?? pluginSystem?.normalizedConfig.slots?.memory,
+    };
+}
+//# sourceMappingURL=plugin-context.js.map

package/dist/runner/plugin-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.js","sourceRoot":"","sources":["../../src/runner/plugin-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAA+B,MAAM,qBAAqB,CAAC;AAWtF;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAGzC;IACC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE1C,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO;QACpC,CAAC,CAAC,sBAAsB,CAAC;YACrB,GAAG,SAAS,CAAC,OAAO;YACpB,OAAO,EAAE;gBACP,GAAG,EAAE,SAAS,CAAC,GAAG;gBAClB,OAAO,EAAE,WAAW;gBACpB,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,YAAY;aAC7C;SACF,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAC,KAAK,IAAI,IAAI,kBAAkB,EAAE;QACtE,eAAe,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;QACpD,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE;QAChG,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,IAAI,YAAY,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM;KAC3F,CAAC;AACJ,CAAC"}

package/dist/runner/run-context.d.ts

@@ -0,0 +1,38 @@
+import { type SessionMetadata } from "../session/session.js";
+import type { PluginHookAgentContext, PluginHookRegistry } from "../plugins/hooks.js";
+import type { AgentRunParams, TranscriptEntry } from "../types.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+/**
+ * Owns the runner's session-local side effects: transcript writes, initial
+ * user-turn persistence, and memory watch bridging. Callers use this as a
+ * single session context and do not need to know how transcript writes trigger
+ * memory sync or deduped memory_changed notifications.
+ */
+export type AgentRunContext = {
+    workspaceDir: string;
+    memoryProviderId?: string;
+    memoryPluginId?: string;
+    appendTranscriptEntry: (entry: TranscriptEntry) => Promise<void>;
+    persistInitialUserEntry: (content: string) => Promise<boolean>;
+    stop: () => void;
+};
+/**
+ * Creates the session-scoped runtime context used by the runner. The returned
+ * object hides memory provider resolution, transcript write options, and the
+ * watch bridge lifecycle behind a small interface.
+ */
+export declare function createRunContext(params: {
+    runParams: AgentRunParams;
+    sessionId: string;
+    hookContext: PluginHookAgentContext;
+    memoryProviderId?: string;
+    memoryPluginId?: string;
+    eventDispatcher: RunEventDispatcher;
+    hookRegistry: PluginHookRegistry;
+}): Promise<AgentRunContext>;
+export declare function buildNewSessionMetadata(params: {
+    sessionId: string;
+    title: string;
+    channel: AgentRunParams["channel"];
+}): SessionMetadata;
+//# sourceMappingURL=run-context.d.ts.map

package/dist/runner/run-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-context.d.ts","sourceRoot":"","sources":["../../src/runner/run-context.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAK3D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,sBAAsB,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,kBAAkB,CAAC;IACpC,YAAY,EAAE,kBAAkB,CAAC;CAClC,GAAG,OAAO,CAAC,eAAe,CAAC,CAyH3B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,GAAG,eAAe,CASlB"}

package/dist/runner/run-context.js

@@ -0,0 +1,159 @@
+import path from "node:path";
+import { appendTranscriptEntry, } from "../session/session.js";
+import { createBuiltinMemoryProvider } from "../memory/builtin-provider.js";
+import { resolveMemoryProvider } from "../memory/provider-registry.js";
+import { startMemoryWatchBridge } from "../memory/watch-bridge.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+const MEMORY_EVENT_DEDUPE_WINDOW_MS = 1_000;
+const EXTERNAL_WATCH_SUPPRESS_WINDOW_MS = 3_000;
+/**
+ * Creates the session-scoped runtime context used by the runner. The returned
+ * object hides memory provider resolution, transcript write options, and the
+ * watch bridge lifecycle behind a small interface.
+ */
+export async function createRunContext(params) {
+    const { runParams, eventDispatcher, hookRegistry } = params;
+    const { sessionId, hookContext, memoryProviderId, memoryPluginId } = params;
+    const workspaceDir = path.join(runParams.dataDir, "workspace");
+    const recentMemoryWrites = new Map();
+    const recentMemoryEvents = new Map();
+    let initialUserEntryPersisted = false;
+    const emitMemoryChanged = async (event) => {
+        const now = Date.now();
+        const normalizedFiles = normalizeMemoryChangedFiles(event.files);
+        if (normalizedFiles.length === 0) {
+            return;
+        }
+        const filteredFiles = event.reason === "external-watch" && event.source === "memory"
+            ? normalizedFiles.filter((file) => {
+                const lastWriteAt = recentMemoryWrites.get(file.toLowerCase()) ?? 0;
+                return now - lastWriteAt > EXTERNAL_WATCH_SUPPRESS_WINDOW_MS;
+            })
+            : normalizedFiles;
+        if (filteredFiles.length === 0) {
+            return;
+        }
+        if (event.reason !== "external-watch" && event.source === "memory") {
+            for (const file of filteredFiles) {
+                recentMemoryWrites.set(file.toLowerCase(), now);
+            }
+        }
+        const dedupeKey = `${event.reason}|${event.source}|${filteredFiles.map((file) => file.toLowerCase()).sort().join("|")}`;
+        const previousEventAt = recentMemoryEvents.get(dedupeKey) ?? 0;
+        if (now - previousEventAt < MEMORY_EVENT_DEDUPE_WINDOW_MS) {
+            return;
+        }
+        recentMemoryEvents.set(dedupeKey, now);
+        const eventToEmit = {
+            ...event,
+            files: filteredFiles,
+        };
+        await eventDispatcher.dispatchProgress(event.sessionId ?? sessionId, {
+            type: "memory_changed",
+            reason: eventToEmit.reason,
+            files: eventToEmit.files,
+            source: eventToEmit.source,
+            providerId: eventToEmit.providerId,
+            timestamp: eventToEmit.timestamp,
+        }).catch(() => { });
+        await hookRegistry.dispatch("memory_changed", eventToEmit, {
+            ...hookContext,
+            sessionId: eventToEmit.sessionId ?? hookContext.sessionId,
+        }).catch(() => { });
+    };
+    const memoryRoot = path.join(runParams.dataDir, ".aimax");
+    const resolvedProvider = resolveMemoryProvider({
+        providerId: memoryProviderId,
+        pluginId: memoryPluginId,
+        dataDir: runParams.dataDir,
+        memoryDir: memoryRoot,
+        sessionId,
+    });
+    const provider = resolvedProvider?.provider ??
+        createBuiltinMemoryProvider({ dataDir: runParams.dataDir, memoryDir: memoryRoot, sessionId });
+    const stopMemoryWatchBridge = startMemoryWatchBridge({
+        dataDir: runParams.dataDir,
+        sessionId,
+        providerId: memoryProviderId ?? memoryPluginId ?? provider.id,
+        provider,
+        onMemoryChanged: emitMemoryChanged,
+    });
+    if (provider.sync) {
+        void provider.sync("session-start").catch(() => { });
+    }
+    const appendWithMemory = async (entry) => {
+        await appendTranscriptEntry(runParams.dataDir, sessionId, entry, buildTranscriptOptions({
+            providerId: memoryProviderId,
+            pluginId: memoryPluginId,
+            onMemoryChanged: emitMemoryChanged,
+        }));
+    };
+    return {
+        workspaceDir,
+        memoryProviderId,
+        memoryPluginId,
+        appendTranscriptEntry: appendWithMemory,
+        persistInitialUserEntry: async (content) => {
+            if (initialUserEntryPersisted) {
+                return false;
+            }
+            await appendWithMemory({
+                role: "user",
+                content,
+                timestamp: new Date().toISOString(),
+            });
+            initialUserEntryPersisted = true;
+            return true;
+        },
+        stop: () => {
+            stopMemoryWatchBridge();
+        },
+    };
+}
+export function buildNewSessionMetadata(params) {
+    const now = new Date().toISOString();
+    return {
+        id: params.sessionId,
+        title: params.title,
+        channel: params.channel,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/**
+ * Transcript writes only need memory identifiers when memory integration is
+ * enabled. This helper keeps that conditional wiring out of callers.
+ */
+function buildTranscriptOptions(params) {
+    if (params.providerId || params.pluginId) {
+        return {
+            providerId: params.providerId,
+            pluginId: params.pluginId,
+            onMemoryChanged: params.onMemoryChanged,
+        };
+    }
+    return { onMemoryChanged: params.onMemoryChanged };
+}
+/**
+ * Normalizes file paths before dedupe so providers can report paths in a
+ * variety of formats without causing duplicate memory_changed events.
+ */
+function normalizeMemoryChangedFiles(files) {
+    const result = [];
+    const seen = new Set();
+    for (const raw of files) {
+        const normalized = raw.replace(/\\/g, "/").replace(/^\.\//, "").trim();
+        if (!normalized) {
+            continue;
+        }
+        const canonical = normalized.toLowerCase() === "memory.md" ? "MEMORY.md" : normalized;
+        const key = canonical.toLowerCase();
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        result.push(canonical);
+    }
+    return result;
+}
+//# sourceMappingURL=run-context.js.map

package/dist/runner/run-context.js.map

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

package/dist/runner/runner-session.d.ts

@@ -0,0 +1,34 @@
+import type { AgentRunParams } from "../types.js";
+import { type AgentRunContext } from "./run-context.js";
+import { type RunnerPluginContext } from "./plugin-context.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+import type { PluginHookAgentContext, PluginHookRegistry } from "../plugins/hooks.js";
+export type RunnerSession = {
+    sessionId: string;
+    isNewSession: boolean;
+    workspaceDir: string;
+    hookContext: PluginHookAgentContext;
+    hookRegistry: PluginHookRegistry;
+    pluginContext: RunnerPluginContext;
+    runContext: AgentRunContext;
+    start: (params: {
+        resetCommand?: {
+            action: "new" | "reset";
+        };
+        previousSessionId?: string;
+        rawMessage?: string;
+        startMessage: string;
+    }) => Promise<void>;
+};
+/**
+ * Establishes the session-scoped objects the runner needs: concrete session
+ * identity, hook context, plugin derivatives, memory/transcript run context,
+ * and start-of-session notifications. Callers should treat the returned value
+ * as the single source of truth for session-local runner state.
+ */
+export declare function createRunnerSession(params: {
+    runParams: AgentRunParams;
+    requestedSessionId?: string;
+    eventDispatcher: RunEventDispatcher;
+}): Promise<RunnerSession>;
+//# sourceMappingURL=runner-session.d.ts.map

package/dist/runner/runner-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-session.d.ts","sourceRoot":"","sources":["../../src/runner/runner-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,sBAAsB,CAAC;IACpC,YAAY,EAAE,kBAAkB,CAAC;IACjC,aAAa,EAAE,mBAAmB,CAAC;IACnC,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,CAAC,MAAM,EAAE;QACd,YAAY,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAA;SAAE,CAAC;QAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,cAAc,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,kBAAkB,CAAC;CACrC,GAAG,OAAO,CAAC,aAAa,CAAC,CAgDzB"}

package/dist/runner/runner-session.js

@@ -0,0 +1,61 @@
+import path from "node:path";
+import { createSession, ensureSession } from "../session/session.js";
+import { createRunContext } from "./run-context.js";
+import { createRunnerPluginContext } from "./plugin-context.js";
+import { startSessionLifecycle } from "./session-lifecycle.js";
+import { RunEventDispatcher } from "./event-dispatcher.js";
+/**
+ * Establishes the session-scoped objects the runner needs: concrete session
+ * identity, hook context, plugin derivatives, memory/transcript run context,
+ * and start-of-session notifications. Callers should treat the returned value
+ * as the single source of truth for session-local runner state.
+ */
+export async function createRunnerSession(params) {
+    const { runParams, requestedSessionId, eventDispatcher } = params;
+    const workspaceDir = path.join(runParams.dataDir, "workspace");
+    let sessionId = requestedSessionId;
+    const isNewSession = !sessionId;
+    if (sessionId) {
+        await ensureSession(runParams.dataDir, sessionId);
+    }
+    else {
+        sessionId = await createSession(runParams.dataDir, runParams.channel);
+    }
+    const hookContext = {
+        sessionId,
+        workspaceDir,
+        channel: runParams.channel,
+    };
+    const pluginContext = createRunnerPluginContext({
+        runParams,
+        hookContext,
+    });
+    const hookRegistry = pluginContext.hookRegistry;
+    const runContext = await createRunContext({
+        runParams,
+        sessionId,
+        hookContext,
+        memoryProviderId: runParams.memory?.providerId,
+        memoryPluginId: pluginContext.memoryPluginId,
+        eventDispatcher,
+        hookRegistry,
+    });
+    return {
+        sessionId,
+        isNewSession,
+        workspaceDir,
+        hookContext,
+        hookRegistry,
+        pluginContext,
+        runContext,
+        start: (startParams) => startSessionLifecycle({
+            sessionId,
+            runParams,
+            hookRegistry,
+            hookContext,
+            eventDispatcher,
+            ...startParams,
+        }),
+    };
+}
+//# sourceMappingURL=runner-session.js.map

package/dist/runner/runner-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-session.js","sourceRoot":"","sources":["../../src/runner/runner-session.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAwB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAA4B,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAmB3D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAIzC;IACC,MAAM,EAAE,SAAS,EAAE,kBAAkB,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/D,IAAI,SAAS,GAAG,kBAAkB,CAAC;IACnC,MAAM,YAAY,GAAG,CAAC,SAAS,CAAC;IAChC,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,WAAW,GAA2B;QAC1C,SAAS;QACT,YAAY;QACZ,OAAO,EAAE,SAAS,CAAC,OAAO;KAC3B,CAAC;IACF,MAAM,aAAa,GAAG,yBAAyB,CAAC;QAC9C,SAAS;QACT,WAAW;KACZ,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC;QACxC,SAAS;QACT,SAAS;QACT,WAAW;QACX,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU;QAC9C,cAAc,EAAE,aAAa,CAAC,cAAc;QAC5C,eAAe;QACf,YAAY;KACb,CAAC,CAAC;IAEH,OAAO;QACL,SAAS;QACT,YAAY;QACZ,YAAY;QACZ,WAAW;QACX,YAAY;QACZ,aAAa;QACb,UAAU;QACV,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,qBAAqB,CAAC;YAC5C,SAAS;YACT,SAAS;YACT,YAAY;YACZ,WAAW;YACX,eAAe;YACf,GAAG,WAAW;SACf,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/runner/runner.d.ts

@@ -1,7 +1,6 @@
 import type { AgentRunParams, AgentRunResult } from "../types.js";
 import { SubagentRegistry } from "../subagent/registry.js";
-/** Generates a session title by truncating the first user message */
-export declare function generateSessionTitle(message: string, maxLength?: number): string;
+export { generateSessionTitle } from "./title.js";
 /**
  * Runs an agent session end-to-end.
  * Supports multi-agent: subagents spawned via sessions_spawn are automatically

package/dist/runner/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAKf,MAAM,aAAa,CAAC;AASrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAsC3D,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAG5E;AA8tCD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,mBAAmB,CAAC,EAAE,gBAAgB,GACrC,OAAO,CAAC,cAAc,CAAC,CAGzB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAW3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAuOlD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,mBAAmB,CAAC,EAAE,gBAAgB,GACrC,OAAO,CAAC,cAAc,CAAC,CAGzB"}