@roackb2/heddle 1.4.0 → 1.6.0

package/dist/src/core/runtime/loop/service.js

@@ -0,0 +1,187 @@
+import { resolve } from 'node:path';
+import { ProviderCredentialRepository } from '../../../core/auth/index.js';
+import { DEFAULT_OPENAI_MODEL } from '../../../core/config.js';
+import { AgentRunService } from '../../../core/agent/index.js';
+import { LlmAdapterService } from '../../../core/llm/index.js';
+import { createLogger } from '../../../core/utils/logger.js';
+import { RuntimeCredentialService } from '../credentials/index.js';
+import { RuntimeToolService } from '../tools/index.js';
+import { AgentLoopCheckpointService } from './checkpoint.js';
+/**
+ * Main programmatic runtime boundary for one evented agent loop execution.
+ */
+export class AgentLoopRuntimeService {
+    static async run(options) {
+        const runId = AgentLoopCheckpointService.generateRunId();
+        const model = options.model ?? options.llm?.info?.model ?? process.env.OPENAI_MODEL ?? process.env.ANTHROPIC_MODEL ?? DEFAULT_OPENAI_MODEL;
+        const provider = LlmAdapterService.inferProvider(model);
+        const workspaceRoot = resolve(options.workspaceRoot ?? process.cwd());
+        const apiKey = options.apiKey ?? RuntimeCredentialService.resolveApiKeyForModel(model);
+        const credentialStorePath = this.resolveCredentialStorePath({ workspaceRoot, stateDir: options.stateDir });
+        const providerCredentialSource = RuntimeCredentialService.resolveCredentialSourceForModel(model, {
+            apiKey,
+            apiKeyProvider: options.apiKey ? 'explicit' : apiKey ? provider : undefined,
+            credentialStorePath,
+        });
+        const llm = options.llm ?? await this.createLoopLlmAdapter({
+            model,
+            apiKey,
+            credentialStorePath,
+            reasoningEffort: options.reasoningEffort,
+        });
+        const logger = options.logger ?? createLogger({ pretty: false, level: 'info', console: false });
+        const tools = this.resolveTools(options, {
+            model,
+            apiKey,
+            providerCredentialSource,
+            workspaceRoot,
+            credentialStorePath,
+        });
+        const now = () => new Date().toISOString();
+        const startedAt = now();
+        logger.info({
+            model,
+            provider,
+            credentialSource: providerCredentialSource.type,
+            credentialProvider: 'provider' in providerCredentialSource ? providerCredentialSource.provider : undefined,
+        }, 'Agent runtime configured');
+        const resumeMetadata = AgentLoopCheckpointService.resolveResumeMetadata(options.resumeFrom);
+        options.onEvent?.({
+            type: 'loop.started',
+            runId,
+            goal: options.goal,
+            model,
+            provider,
+            workspaceRoot,
+            resumedFromCheckpoint: resumeMetadata?.checkpointRunId,
+            timestamp: startedAt,
+        });
+        if (resumeMetadata) {
+            options.onEvent?.({
+                type: 'loop.resumed',
+                runId,
+                fromCheckpoint: resumeMetadata.checkpointRunId,
+                priorTraceEvents: resumeMetadata.priorTraceEvents,
+                timestamp: now(),
+            });
+        }
+        const result = await AgentRunService.run({
+            goal: options.goal,
+            llm,
+            tools,
+            workspaceRoot,
+            maxSteps: options.maxSteps,
+            logger,
+            history: AgentLoopCheckpointService.resolveHistory(options),
+            systemContext: options.systemContext,
+            onAssistantStream: (update) => {
+                options.onEvent?.({
+                    type: 'assistant.stream',
+                    runId,
+                    ...update,
+                    timestamp: now(),
+                });
+                options.onAssistantStream?.(update);
+            },
+            onEvent: (event) => {
+                options.onEvent?.({ type: 'trace', runId, event, timestamp: now() });
+                options.onTraceEvent?.(event);
+            },
+            onToolCalling: (call, step, toolDef) => {
+                options.onEvent?.({
+                    type: 'tool.calling',
+                    runId,
+                    step,
+                    tool: call.tool,
+                    toolCallId: call.id,
+                    input: call.input,
+                    requiresApproval: toolDef.requiresApproval ?? false,
+                    timestamp: now(),
+                });
+            },
+            onToolCompleted: (call, result, step, durationMs) => {
+                options.onEvent?.({
+                    type: 'tool.completed',
+                    runId,
+                    step,
+                    tool: call.tool,
+                    toolCallId: call.id,
+                    result: { ok: result.ok, output: result.output, error: result.error },
+                    durationMs,
+                    timestamp: now(),
+                });
+            },
+            approvalPolicies: options.approvalPolicies,
+            approveToolCall: options.approveToolCall,
+            shouldStop: options.shouldStop,
+            abortSignal: options.abortSignal,
+        });
+        const finishedAt = now();
+        const state = AgentLoopCheckpointService.createFinishedState({
+            runId,
+            goal: options.goal,
+            model,
+            provider,
+            workspaceRoot,
+            startedAt,
+            finishedAt,
+            result,
+        });
+        options.onEvent?.({
+            type: 'loop.finished',
+            runId,
+            outcome: result.outcome,
+            summary: result.summary,
+            usage: result.usage,
+            state,
+            timestamp: finishedAt,
+        });
+        return {
+            ...result,
+            model,
+            provider,
+            workspaceRoot,
+            state,
+        };
+    }
+    static resolveCredentialStorePath(args) {
+        return args.stateDir
+            ? ProviderCredentialRepository.resolveStorePath(resolve(args.workspaceRoot, args.stateDir))
+            : undefined;
+    }
+    static async createLoopLlmAdapter(options) {
+        return LlmAdapterService.create({
+            model: options.model,
+            credentials: {
+                apiKey: options.apiKey,
+                credentialStorePath: options.credentialStorePath,
+            },
+            runtime: {
+                reasoningEffort: options.reasoningEffort,
+            },
+        });
+    }
+    static resolveTools(options, runtime) {
+        const providedTools = options.tools ?? [];
+        const extraTools = options.extraTools ?? [];
+        if (options.includeDefaultTools === false) {
+            return [...providedTools, ...extraTools];
+        }
+        return [
+            ...RuntimeToolService.createDefaultAgentTools({
+                model: runtime.model,
+                apiKey: runtime.apiKey,
+                providerCredentialSource: runtime.providerCredentialSource,
+                credentialStorePath: runtime.credentialStorePath,
+                workspaceRoot: runtime.workspaceRoot,
+                stateDir: options.stateDir,
+                memoryDir: options.memoryDir,
+                searchIgnoreDirs: options.searchIgnoreDirs,
+                includePlanTool: options.includePlanTool,
+            }),
+            ...providedTools,
+            ...extraTools,
+        ];
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/runtime/loop/service.js.map

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

package/dist/src/core/runtime/{events.d.ts → loop/types.d.ts}

@@ -1,5 +1,8 @@
-import type { ChatMessage, LlmProvider, LlmUsage } from '../llm/types.js';
-import type { RunResult, StopReason, TraceEvent } from '../types.js';
+import type { Logger } from 'pino';
+import type { ToolApprovalPolicy } from '../../../core/approvals/types.js';
+import type { RunAgentOptions } from '../../../core/agent/index.js';
+import type { ChatMessage, LlmAdapter, LlmProvider, LlmUsage, ReasoningEffort } from '../../../core/llm/types.js';
+import type { RunResult, StopReason, ToolCall, ToolDefinition, TraceEvent } from '../../../core/types.js';
 export type AgentLoopStatus = 'finished';
 export type AgentLoopState = {
     status: AgentLoopStatus;
@@ -22,10 +25,6 @@ export type AgentLoopCheckpoint = {
     createdAt: string;
     state: AgentLoopState;
 };
-/**
- * Host-facing agent loop events.
- * Stable payload shapes for external integration (CyberLoop, Lucid, etc.)
- */
 export type AgentLoopEvent = {
     type: 'loop.started';
     runId: string;
@@ -81,21 +80,6 @@ export type AgentLoopEvent = {
     checkpoint: AgentLoopCheckpoint;
     step: number;
     timestamp: string;
-} | {
-    type: 'escalation.required';
-    runId: string;
-    task: string;
-    outcome: StopReason;
-    summary: string;
-    step: number;
-    timestamp: string;
-} | {
-    type: 'heartbeat.decision';
-    runId: string;
-    decision: 'continue' | 'pause' | 'complete' | 'escalate';
-    outcome: StopReason;
-    summary: string;
-    timestamp: string;
 } | {
     type: 'loop.finished';
     runId: string;
@@ -105,24 +89,40 @@ export type AgentLoopEvent = {
     state: AgentLoopState;
     timestamp: string;
 };
-export declare function createFinishedAgentLoopState(args: {
-    runId: string;
+export type RunAgentLoopOptions = {
     goal: string;
+    model?: string;
+    reasoningEffort?: ReasoningEffort;
+    apiKey?: string;
+    maxSteps?: number;
+    workspaceRoot?: string;
+    stateDir?: string;
+    memoryDir?: string;
+    searchIgnoreDirs?: string[];
+    systemContext?: string;
+    history?: ChatMessage[];
+    resumeFrom?: AgentLoopState | AgentLoopCheckpoint;
+    llm?: LlmAdapter;
+    tools?: ToolDefinition[];
+    extraTools?: ToolDefinition[];
+    includeDefaultTools?: boolean;
+    includePlanTool?: boolean;
+    logger?: Logger;
+    onEvent?: (event: AgentLoopEvent) => void;
+    onTraceEvent?: (event: TraceEvent) => void;
+    onAssistantStream?: RunAgentOptions['onAssistantStream'];
+    approvalPolicies?: ToolApprovalPolicy[];
+    approveToolCall?: (call: ToolCall, tool: ToolDefinition) => Promise<{
+        approved: boolean;
+        reason?: string;
+    }>;
+    shouldStop?: () => boolean;
+    abortSignal?: AbortSignal;
+};
+export type AgentLoopResult = RunResult & {
     model: string;
     provider: LlmProvider;
     workspaceRoot: string;
-    startedAt: string;
-    finishedAt: string;
-    result: RunResult;
-}): AgentLoopState;
-export declare function createAgentLoopCheckpoint(state: AgentLoopState, options?: {
-    createdAt?: string;
-}): AgentLoopCheckpoint;
-/**
- * Generate a unique run ID for event correlation.
- * Format: run_<timestamp>_<random>
- */
-export declare function generateRunId(): string;
-export declare function getHistoryFromAgentLoopState(state: AgentLoopState): ChatMessage[];
-export declare function getHistoryFromAgentLoopCheckpoint(checkpoint: AgentLoopCheckpoint): ChatMessage[];
-//# sourceMappingURL=events.d.ts.map
+    state: AgentLoopState;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/runtime/loop/types.d.ts.map

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

package/dist/src/core/runtime/loop/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/runtime/loop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/runtime/loop/types.ts"],"names":[],"mappings":""}

package/dist/src/core/runtime/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { RuntimeToolService } from './service.js';
+export type { DefaultAgentToolsOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/runtime/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/runtime/tools/index.js

@@ -0,0 +1,2 @@
+export { RuntimeToolService } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/runtime/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/runtime/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/src/core/runtime/tools/service.d.ts

@@ -0,0 +1,11 @@
+import type { ToolDefinition } from '../../../core/types.js';
+import type { DefaultAgentToolsOptions } from './types.js';
+/**
+ * Owns the default tool bundle policy for generic runtime execution.
+ */
+export declare class RuntimeToolService {
+    static createDefaultAgentTools(options: DefaultAgentToolsOptions): ToolDefinition[];
+    private static createDefaultToolkits;
+    private static createDefaultInternalToolkit;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/runtime/tools/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/tools/service.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,cAAc,EAAE;IAsBnF,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAapC,OAAO,CAAC,MAAM,CAAC,4BAA4B;CAc5C"}

package/dist/src/core/runtime/tools/service.js

@@ -0,0 +1,54 @@
+import { join } from 'node:path';
+import { codingAwarenessToolkit } from '../../../core/tools/toolkits/coding-awareness/toolkit.js';
+import { codingFilesToolkit } from '../../../core/tools/toolkits/coding-files/toolkit.js';
+import { externalContextToolkit } from '../../../core/tools/toolkits/external-context/toolkit.js';
+import { internalToolkit } from '../../../core/tools/toolkits/internal/toolkit.js';
+import { knowledgeToolkit } from '../../../core/tools/toolkits/knowledge/toolkit.js';
+import { shellProcessToolkit } from '../../../core/tools/toolkits/shell-process/toolkit.js';
+import { createToolkitToolBundle } from '../../../core/tools/toolkit.js';
+/**
+ * Owns the default tool bundle policy for generic runtime execution.
+ */
+export class RuntimeToolService {
+    static createDefaultAgentTools(options) {
+        const workspaceRoot = options.workspaceRoot ?? process.cwd();
+        const memoryDir = options.memoryDir ??
+            join(workspaceRoot, options.stateDir ?? '.heddle', 'memory');
+        const memoryMode = options.memoryMode ?? 'read-and-record';
+        return createToolkitToolBundle({
+            toolkits: this.createDefaultToolkits({ includePlanTool: options.includePlanTool }),
+            context: {
+                workspaceRoot,
+                model: options.model,
+                apiKey: options.apiKey,
+                providerCredentialSource: options.providerCredentialSource,
+                credentialStorePath: options.credentialStorePath,
+                memoryDir,
+                memoryMode,
+                searchIgnoreDirs: options.searchIgnoreDirs,
+            },
+        });
+    }
+    static createDefaultToolkits(args) {
+        return [
+            codingAwarenessToolkit,
+            codingFilesToolkit,
+            externalContextToolkit,
+            knowledgeToolkit,
+            this.createDefaultInternalToolkit({ includePlanTool: args.includePlanTool }),
+            shellProcessToolkit,
+        ];
+    }
+    static createDefaultInternalToolkit(args) {
+        if (args.includePlanTool ?? true) {
+            return internalToolkit;
+        }
+        return {
+            id: internalToolkit.id,
+            createTools(context) {
+                return internalToolkit.createTools(context).filter((tool) => tool.name !== 'update_plan');
+            },
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/core/runtime/tools/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../../../src/core/runtime/tools/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAoB,MAAM,yBAAyB,CAAC;AAIpF;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B,MAAM,CAAC,uBAAuB,CAAC,OAAiC;QAC9D,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7D,MAAM,SAAS,GACb,OAAO,CAAC,SAAS;YACjB,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;QAE3D,OAAO,uBAAuB,CAAC;YAC7B,QAAQ,EAAE,IAAI,CAAC,qBAAqB,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;YAClF,OAAO,EAAE;gBACP,aAAa;gBACb,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,wBAAwB,EAAE,OAAO,CAAC,wBAAwB;gBAC1D,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;gBAChD,SAAS;gBACT,UAAU;gBACV,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC3C;SACF,CAAC,CAAC;IACL,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAC,IAEpC;QACC,OAAO;YACL,sBAAsB;YACtB,kBAAkB;YAClB,sBAAsB;YACtB,gBAAgB;YAChB,IAAI,CAAC,4BAA4B,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5E,mBAAmB;SACpB,CAAC;IACJ,CAAC;IAEO,MAAM,CAAC,4BAA4B,CAAC,IAE3C;QACC,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;YACjC,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,OAAO;YACL,EAAE,EAAE,eAAe,CAAC,EAAE;YACtB,WAAW,CAAC,OAAO;gBACjB,OAAO,eAAe,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;YAC5F,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/core/runtime/{default-tools.d.ts → tools/types.d.ts}

@@ -1,5 +1,4 @@
-import type { ToolDefinition } from '../types.js';
-import type { ProviderCredentialSource } from './api-keys.js';
+import type { ProviderCredentialSource } from '../../../core/runtime/credentials/index.js';
 export type DefaultAgentToolsOptions = {
     model: string;
     apiKey?: string;
@@ -12,5 +11,4 @@ export type DefaultAgentToolsOptions = {
     searchIgnoreDirs?: string[];
     includePlanTool?: boolean;
 };
-export declare function createDefaultAgentTools(options: DefaultAgentToolsOptions): ToolDefinition[];
-//# sourceMappingURL=default-tools.d.ts.map
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/runtime/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAEpF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,YAAY,GAAG,aAAa,CAAC;IACvE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC"}

package/dist/src/core/runtime/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/runtime/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/runtime/tools/types.ts"],"names":[],"mappings":""}

package/dist/src/core/runtime/workspaces/index.d.ts

@@ -0,0 +1,5 @@
+export { FileWorkspaceRepository } from './repository.js';
+export { RuntimeWorkspaceService } from './service.js';
+export type { CreateWorkspaceDescriptorInput, RenameWorkspaceDescriptorInput, ResolvedWorkspaceContext, SetActiveWorkspaceInput, WorkspaceCatalog, WorkspaceDescriptor, WorkspaceRootConfig, } from './types.js';
+export { DEFAULT_WORKSPACE_ID } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/runtime/workspaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EACV,8BAA8B,EAC9B,8BAA8B,EAC9B,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/runtime/workspaces/index.js

@@ -0,0 +1,4 @@
+export { FileWorkspaceRepository } from './repository.js';
+export { RuntimeWorkspaceService } from './service.js';
+export { DEFAULT_WORKSPACE_ID } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/runtime/workspaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAUvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/core/runtime/workspaces/repository.d.ts

@@ -0,0 +1,14 @@
+import type { WorkspaceCatalog } from './types.js';
+export declare class FileWorkspaceRepository {
+    private readonly catalogPath;
+    constructor(args: {
+        catalogPath: string;
+    });
+    static resolveCatalogPath(stateRoot: string): string;
+    exists(): boolean;
+    readRaw(): unknown;
+    save(catalog: WorkspaceCatalog): void;
+    path(): string;
+    static forStateRoot(stateRoot: string): FileWorkspaceRepository;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/src/core/runtime/workspaces/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/repository.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE;IAIzC,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIpD,MAAM,IAAI,OAAO;IAIjB,OAAO,IAAI,OAAO;IAIlB,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKrC,IAAI,IAAI,MAAM;IAId,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB;CAKhE"}

package/dist/src/core/runtime/workspaces/repository.js

@@ -0,0 +1,38 @@
+/**
+ * File-backed runtime workspace repository.
+ *
+ * Owns catalog paths and JSON file I/O. Workspace semantics live in
+ * `RuntimeWorkspaceService`; callers should not read or write workspace catalog
+ * files directly.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { WorkspaceCatalogSchema } from './schemas.js';
+export class FileWorkspaceRepository {
+    catalogPath;
+    constructor(args) {
+        this.catalogPath = args.catalogPath;
+    }
+    static resolveCatalogPath(stateRoot) {
+        return join(stateRoot, 'workspaces.catalog.json');
+    }
+    exists() {
+        return existsSync(this.catalogPath);
+    }
+    readRaw() {
+        return JSON.parse(readFileSync(this.catalogPath, 'utf8'));
+    }
+    save(catalog) {
+        mkdirSync(dirname(this.catalogPath), { recursive: true });
+        writeFileSync(this.catalogPath, `${JSON.stringify(WorkspaceCatalogSchema.parse(catalog), null, 2)}\n`, 'utf8');
+    }
+    path() {
+        return this.catalogPath;
+    }
+    static forStateRoot(stateRoot) {
+        return new FileWorkspaceRepository({
+            catalogPath: FileWorkspaceRepository.resolveCatalogPath(resolve(stateRoot)),
+        });
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/src/core/runtime/workspaces/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD,MAAM,OAAO,uBAAuB;IACjB,WAAW,CAAS;IAErC,YAAY,IAA6B;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,SAAiB;QACzC,OAAO,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACpD,CAAC;IAED,MAAM;QACJ,OAAO,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAY,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,OAAyB;QAC5B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjH,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,SAAiB;QACnC,OAAO,IAAI,uBAAuB,CAAC;YACjC,WAAW,EAAE,uBAAuB,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/core/runtime/workspaces/schemas.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Zod schemas for runtime workspace catalog persistence.
+ *
+ * This file is the human-readable JSON contract for `.heddle/workspaces.catalog.json`.
+ */
+import { z } from 'zod';
+export declare const WorkspaceDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    anchorRoot: z.ZodString;
+    repoRoots: z.ZodArray<z.ZodString>;
+    stateRoot: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const WorkspaceCatalogSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    activeWorkspaceId: z.ZodString;
+    workspaces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        anchorRoot: z.ZodString;
+        repoRoots: z.ZodArray<z.ZodString>;
+        stateRoot: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const WorkspaceCatalogReadSchema: z.ZodObject<{
+    version: z.ZodCatch<z.ZodOptional<z.ZodLiteral<1>>>;
+    activeWorkspaceId: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    workspaces: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        anchorRoot: z.ZodOptional<z.ZodString>;
+        repoRoots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        stateRoot: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/src/core/runtime/workspaces/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;iBAQpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAIjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;iBAIrC,CAAC"}

package/dist/src/core/runtime/workspaces/schemas.js

@@ -0,0 +1,26 @@
+/**
+ * Zod schemas for runtime workspace catalog persistence.
+ *
+ * This file is the human-readable JSON contract for `.heddle/workspaces.catalog.json`.
+ */
+import { z } from 'zod';
+export const WorkspaceDescriptorSchema = z.object({
+    id: z.string().describe('Stable workspace identifier used by host surfaces and daemon registration.'),
+    name: z.string().describe('Human-facing workspace name shown in control-plane workspace lists.'),
+    anchorRoot: z.string().describe('Primary filesystem root represented by this workspace.'),
+    repoRoots: z.array(z.string()).describe('Repository roots grouped into this workspace.'),
+    stateRoot: z.string().describe('Heddle state directory for this workspace.'),
+    createdAt: z.string().describe('Timestamp when this workspace descriptor was created.'),
+    updatedAt: z.string().describe('Timestamp when this workspace descriptor was last changed.'),
+});
+export const WorkspaceCatalogSchema = z.object({
+    version: z.literal(1).describe('Workspace catalog format version.'),
+    activeWorkspaceId: z.string().describe('Workspace identifier currently selected by host surfaces.'),
+    workspaces: z.array(WorkspaceDescriptorSchema).describe('Known workspace descriptors.'),
+});
+export const WorkspaceCatalogReadSchema = z.object({
+    version: z.literal(1).optional().catch(1),
+    activeWorkspaceId: z.string().optional().catch(undefined),
+    workspaces: z.array(WorkspaceDescriptorSchema.partial()).optional().catch(undefined),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/src/core/runtime/workspaces/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;IACrG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC;IAChG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACzF,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACxF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC5E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACvF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACnE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IACnG,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACxF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;CACrF,CAAC,CAAC"}

package/dist/src/core/runtime/workspaces/service.d.ts

@@ -0,0 +1,15 @@
+import { type CreateWorkspaceDescriptorInput, type RenameWorkspaceDescriptorInput, type ResolvedWorkspaceContext, type SetActiveWorkspaceInput, type WorkspaceCatalog, type WorkspaceRootConfig } from './types.js';
+export declare class RuntimeWorkspaceService {
+    static ensureCatalog(config: WorkspaceRootConfig): WorkspaceCatalog;
+    static resolveContext(config: WorkspaceRootConfig): ResolvedWorkspaceContext;
+    static setActive(input: SetActiveWorkspaceInput): ResolvedWorkspaceContext;
+    static rename(input: RenameWorkspaceDescriptorInput): ResolvedWorkspaceContext;
+    static createDescriptor(input: CreateWorkspaceDescriptorInput): ResolvedWorkspaceContext;
+    static readCatalog(catalogPath: string, config: WorkspaceRootConfig): WorkspaceCatalog;
+    private static saveResolvedCatalog;
+    private static createDefaultCatalog;
+    private static deriveDefaultWorkspaceName;
+    private static normalizeCatalog;
+    private static normalizeDescriptor;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/src/core/runtime/workspaces/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../../src/core/runtime/workspaces/service.ts"],"names":[],"mappings":"AAUA,OAAO,EAEL,KAAK,8BAA8B,EACnC,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EAErB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,qBAAa,uBAAuB;IAClC,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB;IAmBnE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,wBAAwB;IAkB5E,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,wBAAwB;IAa1E,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,8BAA8B,GAAG,wBAAwB;IAoB9E,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,8BAA8B,GAAG,wBAAwB;IAuCxF,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,gBAAgB;IAStF,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAIlC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmBnC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAKzC,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA+B/B,OAAO,CAAC,MAAM,CAAC,mBAAmB;CAsBnC"}