pulseed 0.6.5 → 0.6.6

package/dist/tools/types.d.ts

@@ -1,6 +1,8 @@
 import { z } from "zod";
 import type { ExecutionPolicy, SubagentRole } from "../orchestrator/execution/agent-loop/execution-policy.js";
-import type { HostToolExecutionDecision } from "./execution-orchestrator.js";
+import type { PermissionGrantRecord } from "../runtime/store/permission-grant-store.js";
+import type { PermissionWaitCanonicalPlan, PermissionWaitPlanStore } from "../runtime/store/permission-wait-plan-store.js";
+import type { CapabilityAuditRecord, CapabilityOperationKind, CapabilityRiskClass, CapabilitySideEffectProfile, CapabilityVerificationRef } from "../runtime/store/capability-verification-schemas.js";
 export declare const ToolExecutionReasonSchema: z.ZodEnum<["approval_denied", "permission_denied", "policy_blocked", "dry_run", "tool_error", "timed_out", "interrupted", "sandbox_required", "escalation_required", "stale_state"]>;
 export declare const ToolResultSchema: z.ZodObject<{
     /** Whether the tool invocation succeeded */
@@ -54,13 +56,13 @@ export declare const ToolResultSchema: z.ZodObject<{
     durationMs: number;
     error?: string | undefined;
     data?: unknown;
+    artifacts?: string[] | undefined;
     execution?: {
         status: "executed" | "not_executed";
         message?: string | undefined;
         reason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     } | undefined;
     contextModifier?: string | undefined;
-    artifacts?: string[] | undefined;
     truncated?: {
         originalChars: number;
         overflowPath?: string | undefined;
@@ -71,23 +73,33 @@ export declare const ToolResultSchema: z.ZodObject<{
     durationMs: number;
     error?: string | undefined;
     data?: unknown;
+    artifacts?: string[] | undefined;
     execution?: {
         status: "executed" | "not_executed";
         message?: string | undefined;
         reason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     } | undefined;
     contextModifier?: string | undefined;
-    artifacts?: string[] | undefined;
     truncated?: {
         originalChars: number;
         overflowPath?: string | undefined;
     } | undefined;
 }>;
 export type ToolResult = z.infer<typeof ToolResultSchema>;
+export type HostToolExecutionDecisionStatus = "allowed" | "denied" | "needs_permission" | "needs_sandbox" | "needs_escalation" | "fail_closed";
+export interface HostToolExecutionDecision {
+    status: HostToolExecutionDecisionStatus;
+    reason: string;
+    executionReason?: NonNullable<ToolResult["execution"]>["reason"];
+    requiredSandboxMode?: "workspace_write" | "danger_full_access";
+    requiredApprovalPolicy?: "on_request";
+}
 export declare const ToolPermissionLevelSchema: z.ZodEnum<["read_only", "read_metrics", "write_local", "execute", "write_remote"]>;
 export type ToolPermissionLevel = z.infer<typeof ToolPermissionLevelSchema>;
 export declare const ToolActivityCategorySchema: z.ZodEnum<["search", "read", "planning", "command", "file_create", "file_modify", "test", "approval"]>;
 export type ToolActivityCategory = z.infer<typeof ToolActivityCategorySchema>;
+export declare const GatewayToolExposureSchema: z.ZodEnum<["default_safe", "approval_required", "runtime_control", "never"]>;
+export type GatewayToolExposure = z.infer<typeof GatewayToolExposureSchema>;
 export declare const ToolMetadataSchema: z.ZodObject<{
     /** Unique tool name (e.g., "glob", "shell") */
     name: z.ZodString;
@@ -125,11 +137,16 @@ export declare const ToolMetadataSchema: z.ZodObject<{
      * semantics from tool names.
      */
     activityCategory: z.ZodOptional<z.ZodEnum<["search", "read", "planning", "command", "file_create", "file_modify", "test", "approval"]>>;
+    /**
+     * Explicit gateway exposure policy. Read-only is necessary but not sufficient
+     * for external chat surfaces; tools must opt into the gateway catalog.
+     */
+    gatewayExposure: z.ZodOptional<z.ZodEnum<["default_safe", "approval_required", "runtime_control", "never"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     tags: string[];
     aliases: string[];
-    permissionLevel: "read_only" | "read_metrics" | "write_local" | "execute" | "write_remote";
+    permissionLevel: "execute" | "write_remote" | "read_only" | "read_metrics" | "write_local";
     isReadOnly: boolean;
     isDestructive: boolean;
     shouldDefer: boolean;
@@ -137,10 +154,11 @@ export declare const ToolMetadataSchema: z.ZodObject<{
     maxConcurrency: number;
     maxOutputChars: number;
     requiresNetwork?: boolean | undefined;
-    activityCategory?: "read" | "command" | "approval" | "search" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    activityCategory?: "read" | "search" | "command" | "approval" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    gatewayExposure?: "never" | "approval_required" | "runtime_control" | "default_safe" | undefined;
 }, {
     name: string;
-    permissionLevel: "read_only" | "read_metrics" | "write_local" | "execute" | "write_remote";
+    permissionLevel: "execute" | "write_remote" | "read_only" | "read_metrics" | "write_local";
     isReadOnly: boolean;
     isDestructive: boolean;
     tags?: string[] | undefined;
@@ -150,7 +168,8 @@ export declare const ToolMetadataSchema: z.ZodObject<{
     maxConcurrency?: number | undefined;
     maxOutputChars?: number | undefined;
     requiresNetwork?: boolean | undefined;
-    activityCategory?: "read" | "command" | "approval" | "search" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    activityCategory?: "read" | "search" | "command" | "approval" | "planning" | "file_create" | "file_modify" | "test" | undefined;
+    gatewayExposure?: "never" | "approval_required" | "runtime_control" | "default_safe" | undefined;
 }>;
 export type ToolMetadata = z.infer<typeof ToolMetadataSchema>;
 /**
@@ -198,6 +217,36 @@ export interface ToolDescriptionContext {
     /** Available data sources */
     dataSources?: string[];
 }
+export interface CapabilityExecutionContext {
+    operationId?: string;
+    providerRef?: string;
+    assetRef?: string;
+    capabilityId?: string;
+    operationKind?: CapabilityOperationKind;
+    toolName?: string;
+    payloadClass?: string;
+    riskClass?: CapabilityRiskClass;
+    sideEffectProfile?: CapabilitySideEffectProfile;
+    userDirected?: boolean;
+    initiatedBy?: string;
+    sourceSurface?: string;
+    readinessSnapshotRefs?: string[];
+    autonomyDecisionRef?: string;
+    approvalRefs?: string[];
+    executionRefs?: string[];
+    userVisibleEffect?: string;
+    sideEffectSummary?: string;
+}
+export interface CapabilityExecutionResolutionInput {
+    toolName: string;
+    toolMetadata: ToolMetadata;
+    rawInput: unknown;
+    operationKind: CapabilityOperationKind;
+    payloadClass: string;
+    riskClass: CapabilityRiskClass;
+    sideEffectProfile: CapabilitySideEffectProfile;
+}
+export type CapabilityExecutionResolver = (input: CapabilityExecutionResolutionInput) => CapabilityExecutionContext | null | Promise<CapabilityExecutionContext | null>;
 export interface ToolCallContext {
     /** Current working directory */
     cwd: string;
@@ -224,6 +273,31 @@ export interface ToolCallContext {
         currentEpoch: string;
         observedEpoch?: string;
     };
+    /** Optional durable run identifier for scope-bound permission grants. */
+    runId?: string;
+    /** Optional turn identifier for scope-bound permission grants. */
+    turnId?: string;
+    /** Optional project identifier for scope-bound permission grants. */
+    projectId?: string;
+    /** Durable permission grants available to the host/tool permission path. */
+    permissionGrantStore?: {
+        list(): Promise<PermissionGrantRecord[]>;
+        recordUse(grantId: string, input?: {
+            used_at?: number;
+            audit_ref?: string;
+        }): Promise<PermissionGrantRecord | null>;
+    };
+    /** Durable canonical plans for approval-gated tool calls. */
+    permissionWaitPlanStore?: Pick<PermissionWaitPlanStore, "createWaiting" | "markApproved" | "markDenied" | "markExpired" | "resumeApproved">;
+    /** Durable operation evidence store for capability runtime production executions. */
+    capabilityVerificationStore?: {
+        saveVerification(record: CapabilityVerificationRef): Promise<CapabilityVerificationRef>;
+        saveAudit(record: CapabilityAuditRecord): Promise<CapabilityAuditRecord>;
+    };
+    /** Typed capability operation context supplied by production caller paths. */
+    capabilityExecution?: CapabilityExecutionContext;
+    /** Optional resolver that binds production tool calls to current capability operation contracts. */
+    capabilityExecutionResolver?: CapabilityExecutionResolver;
     /** Optional subagent role for delegated runs. */
     agentRole?: SubagentRole;
     /** Abort signal for cancellation */
@@ -276,26 +350,39 @@ export interface ApprovalRequest {
     isDestructive: boolean;
     reversibility: "reversible" | "irreversible" | "unknown";
     callId?: string;
+    sessionId?: string;
+    runId?: string;
+    turnId?: string;
+    approvalId?: string;
+    permissionWaitPlanId?: string;
+    canonicalPermissionPlan?: PermissionWaitCanonicalPlan;
+    permissionGrantDecision?: unknown;
 }
 export declare const PermissionCheckResultSchema: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
     status: z.ZodLiteral<"allowed">;
+    permissionGrantDecision: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     status: "allowed";
+    permissionGrantDecision?: unknown;
 }, {
     status: "allowed";
+    permissionGrantDecision?: unknown;
 }>, z.ZodObject<{
     status: z.ZodLiteral<"denied">;
     reason: z.ZodString;
     executionReason: z.ZodOptional<z.ZodEnum<["approval_denied", "permission_denied", "policy_blocked", "dry_run", "tool_error", "timed_out", "interrupted", "sandbox_required", "escalation_required", "stale_state"]>>;
     policyDecision: z.ZodOptional<z.ZodUnknown>;
+    permissionGrantDecision: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     status: "denied";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }, {
     status: "denied";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }>, z.ZodObject<{
@@ -303,18 +390,22 @@ export declare const PermissionCheckResultSchema: z.ZodDiscriminatedUnion<"statu
     reason: z.ZodString;
     executionReason: z.ZodOptional<z.ZodEnum<["approval_denied", "permission_denied", "policy_blocked", "dry_run", "tool_error", "timed_out", "interrupted", "sandbox_required", "escalation_required", "stale_state"]>>;
     policyDecision: z.ZodOptional<z.ZodUnknown>;
+    permissionGrantDecision: z.ZodOptional<z.ZodUnknown>;
 }, "strip", z.ZodTypeAny, {
     status: "needs_approval";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }, {
     status: "needs_approval";
     reason: string;
+    permissionGrantDecision?: unknown;
     executionReason?: "timed_out" | "interrupted" | "approval_denied" | "permission_denied" | "policy_blocked" | "dry_run" | "tool_error" | "sandbox_required" | "escalation_required" | "stale_state" | undefined;
     policyDecision?: unknown;
 }>]>;
 export type PermissionCheckResult = z.infer<typeof PermissionCheckResultSchema> & {
     policyDecision?: HostToolExecutionDecision;
+    permissionGrantDecision?: unknown;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

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

package/dist/tools/types.js

@@ -1,5 +1,10 @@
 import { z } from "zod";
 // --- Tool Result ---
+const NonNegativeSafeIntegerSchema = z.number()
+    .finite()
+    .int()
+    .nonnegative()
+    .max(Number.MAX_SAFE_INTEGER);
 export const ToolExecutionReasonSchema = z.enum([
     "approval_denied",
     "permission_denied",
@@ -31,7 +36,7 @@ export const ToolResultSchema = z.object({
         message: z.string().optional(),
     }).optional(),
     /** Duration of the tool call in milliseconds */
-    durationMs: z.number(),
+    durationMs: NonNegativeSafeIntegerSchema,
     /** Optional context modifier: instructions to append to subsequent LLM context */
     contextModifier: z.string().optional(),
     /**
@@ -41,7 +46,7 @@ export const ToolResultSchema = z.object({
     artifacts: z.array(z.string()).optional(),
     /** Set when output was truncated; contains the original character count */
     truncated: z.object({
-        originalChars: z.number(),
+        originalChars: NonNegativeSafeIntegerSchema,
         overflowPath: z.string().optional()
     }).optional(),
 });
@@ -64,12 +69,18 @@ export const ToolActivityCategorySchema = z.enum([
     "test",
     "approval",
 ]);
+export const GatewayToolExposureSchema = z.enum([
+    "default_safe",
+    "approval_required",
+    "runtime_control",
+    "never",
+]);
 // --- Tool Metadata ---
 export const ToolMetadataSchema = z.object({
     /** Unique tool name (e.g., "glob", "shell") */
-    name: z.string(),
+    name: z.string().min(1),
     /** Alternative names for discovery */
-    aliases: z.array(z.string()).default([]),
+    aliases: z.array(z.string().min(1)).default([]),
     /** Permission level */
     permissionLevel: ToolPermissionLevelSchema,
     /** Whether this tool is read-only (no side effects) */
@@ -86,14 +97,14 @@ export const ToolMetadataSchema = z.object({
     /** Whether this tool should always be loaded into context */
     alwaysLoad: z.boolean().default(false),
     /** Maximum concurrent invocations (0 = unlimited) */
-    maxConcurrency: z.number().default(0),
+    maxConcurrency: z.number().finite().int().nonnegative().max(Number.MAX_SAFE_INTEGER).default(0),
     /** Maximum characters of tool output to pass to LLM (excess persisted to disk) */
-    maxOutputChars: z.number().default(8000),
+    maxOutputChars: z.number().finite().int().positive().max(Number.MAX_SAFE_INTEGER).default(8000),
     /**
      * Tags for categorization and filtering.
      * Used by the context-filtered tier of the registry.
      */
-    tags: z.array(z.string()).default([]),
+    tags: z.array(z.string().min(1)).default([]),
     /** Whether this tool requires network access even if it is otherwise read-only. */
     requiresNetwork: z.boolean().optional(),
     /**
@@ -102,20 +113,27 @@ export const ToolMetadataSchema = z.object({
      * semantics from tool names.
      */
     activityCategory: ToolActivityCategorySchema.optional(),
+    /**
+     * Explicit gateway exposure policy. Read-only is necessary but not sufficient
+     * for external chat surfaces; tools must opt into the gateway catalog.
+     */
+    gatewayExposure: GatewayToolExposureSchema.optional(),
 });
 export const PermissionCheckResultSchema = z.discriminatedUnion("status", [
-    z.object({ status: z.literal("allowed") }),
+    z.object({ status: z.literal("allowed"), permissionGrantDecision: z.unknown().optional() }),
     z.object({
         status: z.literal("denied"),
         reason: z.string(),
         executionReason: ToolExecutionReasonSchema.optional(),
         policyDecision: z.unknown().optional(),
+        permissionGrantDecision: z.unknown().optional(),
     }),
     z.object({
         status: z.literal("needs_approval"),
         reason: z.string(),
         executionReason: ToolExecutionReasonSchema.optional(),
         policyDecision: z.unknown().optional(),
+        permissionGrantDecision: z.unknown().optional(),
     }),
 ]);
 //# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulseed",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "PulSeed is a lifelong personal agent that remembers your goals, watches the world with you, and keeps helping move your life forward.",
   "type": "module",
   "main": "dist/index.js",
@@ -50,6 +50,7 @@
     "build": "npm run clean && tsc -p tsconfig.build.json --incremental false && node scripts/fix-bin-mode.mjs",
     "build:watch": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
     "check:docs": "node scripts/check-docs.mjs",
+    "check:database-first-legacy-stores": "node scripts/check-database-first-legacy-stores.mjs",
     "check:subpackages": "node scripts/check-subpackages.mjs --changed",
     "audit:prod": "npm audit --omit=dev --audit-level=high",
     "prepack": "npm run build",
@@ -58,13 +59,18 @@
     "release": "node scripts/release.mjs",
     "test": "npm run test:unit",
     "test:unit": "vitest run --config vitest.unit.config.ts",
+    "test:contracts": "vitest run --config vitest.contracts.config.ts",
+    "test:golden-traces": "vitest run --config vitest.golden-traces.config.ts",
+    "test:replay": "vitest run --config vitest.replay.config.ts",
+    "test:slow": "vitest run --config vitest.slow.config.ts",
     "test:smoke": "vitest run --config vitest.smoke.config.ts",
     "test:integration": "vitest run --config vitest.integration.config.ts",
-    "test:all": "npm run test:unit && npm run test:smoke && npm run test:integration",
+    "test:all": "npm run test:unit && npm run test:contracts && npm run test:golden-traces && npm run test:replay && npm run test:smoke && npm run test:integration",
     "test:e2e": "vitest run tests/e2e",
     "test:dogfood": "vitest run src/orchestrator/execution/agent-loop/__tests__/agent-loop-dogfood-benchmark.test.ts",
     "test:kaggle-training": "vitest run src/orchestrator/execution/agent-loop/__tests__/kaggle-training-benchmark.test.ts",
     "dogfood:agentloop:real": "npm run build && node dist/orchestrator/execution/agent-loop/agent-loop-real-dogfood.js",
+    "smoke:gateway-direct-chat-latency": "npm run build && node dist/runtime/gateway/direct-chat-latency-smoke.js",
     "test:runtime-long-run": "vitest run --config vitest.runtime-long-run.config.ts",
     "test:memory-correction-eval": "vitest run --config vitest.runtime-long-run.config.ts tests/slow/memory-correction-retrieval-eval.test.ts",
     "test:lifelong-agent-eval": "vitest run --config vitest.runtime-long-run.config.ts tests/slow/lifelong-agent-memory-profile-eval.test.ts",
@@ -96,6 +102,7 @@
     "nodemailer": "^8.0.5",
     "openai": "^6.27.0",
     "react": "^19.2.4",
+    "string-width": "^7.2.0",
     "zod": "^3.22.0",
     "zod-to-json-schema": "^3.25.2"
   },

package/dist/base/state/state-lock.d.ts

@@ -1,17 +0,0 @@
-/**
- * Per-goal advisory locking using lockfiles.
- * Lock path: <baseDir>/locks/goals/<goalId>.lock/
- * Transition compatibility: also acquire <baseDir>/goals/<goalId>/.lock
- * when the legacy goal directory already exists.
- * Uses mkdir as atomic primitive (POSIX: EEXIST = lock held).
- */
-export interface LockOptions {
-    maxRetries?: number;
-    initialDelayMs?: number;
-    maxTotalMs?: number;
-}
-/** Acquire an advisory lock for the given goalId. Throws if timeout exceeded. */
-export declare function acquireLock(goalId: string, baseDir: string, opts?: LockOptions): Promise<void>;
-/** Release the advisory lock for the given goalId. No-op if lock does not exist. */
-export declare function releaseLock(goalId: string, baseDir: string): Promise<void>;
-//# sourceMappingURL=state-lock.d.ts.map

package/dist/base/state/state-lock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"state-lock.d.ts","sourceRoot":"","sources":["../../../src/base/state/state-lock.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAsHD,iFAAiF;AACjF,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,oFAAoF;AACpF,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF"}

package/dist/base/state/state-lock.js

@@ -1,134 +0,0 @@
-import * as fsp from "node:fs/promises";
-import * as path from "node:path";
-function lockPath(goalId, baseDir) {
-    return path.join(baseDir, "locks", "goals", `${goalId}.lock`);
-}
-function legacyLockPath(goalId, baseDir) {
-    return path.join(baseDir, "goals", goalId, ".lock");
-}
-function pidFilePath(lockDir) {
-    return path.join(lockDir, "pid");
-}
-async function pathExists(dir) {
-    try {
-        await fsp.access(dir);
-        return true;
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return false;
-        throw err;
-    }
-}
-async function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function tryAcquire(lockDir, checkStale = false) {
-    try {
-        await fsp.mkdir(lockDir, { recursive: false });
-        await fsp.writeFile(pidFilePath(lockDir), String(process.pid), "utf-8");
-        return true;
-    }
-    catch (err) {
-        if (err.code === "EEXIST") {
-            if (checkStale) {
-                await clearStaleLock(lockDir);
-                // Retry once after clearing stale lock
-                try {
-                    await fsp.mkdir(lockDir, { recursive: false });
-                    await fsp.writeFile(pidFilePath(lockDir), String(process.pid), "utf-8");
-                    return true;
-                }
-                catch (retryErr) {
-                    if (retryErr.code === "EEXIST") {
-                        return false;
-                    }
-                    throw retryErr;
-                }
-            }
-            return false;
-        }
-        throw err;
-    }
-}
-async function clearStaleLock(lockDir) {
-    try {
-        const pidStr = await fsp.readFile(pidFilePath(lockDir), "utf-8");
-        const pid = parseInt(pidStr.trim(), 10);
-        if (!isNaN(pid) && !(await isProcessAlive(pid))) {
-            await fsp.rm(lockDir, { recursive: true, force: true });
-        }
-    }
-    catch {
-        // If we cannot read pid, leave the lock intact
-    }
-}
-async function acquireLockDir(lockDir, label, opts, createParent = true) {
-    const maxRetries = opts?.maxRetries ?? 5;
-    const initialDelayMs = opts?.initialDelayMs ?? 50;
-    const maxTotalMs = opts?.maxTotalMs ?? 500;
-    if (createParent) {
-        await fsp.mkdir(path.dirname(lockDir), { recursive: true });
-    }
-    const start = Date.now();
-    let delay = initialDelayMs;
-    for (let attempt = 0; attempt <= maxRetries; attempt++) {
-        if (await tryAcquire(lockDir, true)) {
-            return;
-        }
-        if (Date.now() - start >= maxTotalMs) {
-            throw new Error(`acquireLock: timeout exceeded for "${label}" after ${maxTotalMs}ms`);
-        }
-        await new Promise((resolve) => setTimeout(resolve, delay));
-        delay = Math.min(delay * 2, maxTotalMs);
-    }
-    throw new Error(`acquireLock: max retries exceeded for "${label}"`);
-}
-async function releaseLockDir(lockDir) {
-    try {
-        await fsp.rm(lockDir, { recursive: true, force: true });
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return;
-        throw err;
-    }
-}
-async function shouldAcquireLegacyLock(goalId, baseDir) {
-    return pathExists(path.join(baseDir, "goals", goalId));
-}
-/** Acquire an advisory lock for the given goalId. Throws if timeout exceeded. */
-export async function acquireLock(goalId, baseDir, opts) {
-    const legacyLockDir = legacyLockPath(goalId, baseDir);
-    const needsLegacyLock = await shouldAcquireLegacyLock(goalId, baseDir);
-    if (needsLegacyLock) {
-        try {
-            await acquireLockDir(legacyLockDir, `${goalId} legacy`, opts, false);
-        }
-        catch (err) {
-            if (err.code !== "ENOENT")
-                throw err;
-        }
-    }
-    const stableLockDir = lockPath(goalId, baseDir);
-    try {
-        await acquireLockDir(stableLockDir, goalId, opts);
-    }
-    catch (err) {
-        if (needsLegacyLock)
-            await releaseLockDir(legacyLockDir);
-        throw err;
-    }
-}
-/** Release the advisory lock for the given goalId. No-op if lock does not exist. */
-export async function releaseLock(goalId, baseDir) {
-    await releaseLockDir(lockPath(goalId, baseDir));
-    await releaseLockDir(legacyLockPath(goalId, baseDir));
-}
-//# sourceMappingURL=state-lock.js.map

package/dist/base/state/state-lock.js.map

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

package/dist/base/state/state-manager-goal-state.d.ts

@@ -1,40 +0,0 @@
-import type { Goal } from "../types/goal.js";
-import type { Task } from "../types/task.js";
-import type { Logger } from "../../runtime/logger.js";
-export type GoalLocationKind = "active" | "archive";
-export interface GoalStorageLocation {
-    kind: GoalLocationKind;
-    dir: string;
-    goalJsonPath: string;
-}
-export interface GoalArchiveHelpers {
-    baseDir: string;
-    logger?: Logger;
-    pathExists: (filePath: string) => Promise<boolean>;
-    atomicRead: <T>(filePath: string) => Promise<T | null>;
-    atomicWrite: (filePath: string, data: unknown) => Promise<void>;
-    loadGoal: (goalId: string) => Promise<Goal | null>;
-    cleanupActiveGoalState: (goalId: string) => Promise<void>;
-    goalWriteProtectedOperation: (goalId: string, op: string, data: unknown, fn: () => Promise<void>) => Promise<void>;
-    commitArchiveGoal: (stagingBase: string, archiveBase: string) => Promise<void>;
-}
-export declare function goalStorageLocation(baseDir: string, goalId: string, kind: GoalLocationKind): GoalStorageLocation;
-export declare function archiveGoalDir(baseDir: string, goalId: string): string;
-export declare function archiveGoalStagingDir(baseDir: string, goalId: string): string;
-export declare function archiveCompleteMarkerPath(archiveBase: string): string;
-export declare function resolveWithinBase(baseDir: string, ...segments: string[]): string | null;
-export declare function taskStorageDirs(baseDir: string, goalId: string): {
-    activeDir: string | null;
-    archiveDir: string | null;
-};
-export declare function readTasksFromDir(tasksDir: string, deps: {
-    atomicRead: <T>(filePath: string) => Promise<T | null>;
-    isEnoent: (error: unknown) => boolean;
-}): Promise<Task[]>;
-export declare function resolveGoalLocation(baseDir: string, goalId: string, includeArchive: boolean, pathExistsFn: (filePath: string) => Promise<boolean>): Promise<GoalStorageLocation | null>;
-export declare function loadGoalForChildTraversal(goalId: string, location: GoalStorageLocation, deps: Pick<GoalArchiveHelpers, "atomicRead" | "loadGoal" | "logger">): Promise<Goal | null>;
-export declare function visitChildGoals(goalId: string, location: GoalStorageLocation, visited: Set<string>, deps: Pick<GoalArchiveHelpers, "atomicRead" | "loadGoal" | "logger">, visit: (childId: string, visited: Set<string>) => Promise<boolean>): Promise<void>;
-export declare function listArchivedGoals(baseDir: string, pathExistsFn: (filePath: string) => Promise<boolean>): Promise<string[]>;
-export declare function listRecoverableArchivedGoalIds(baseDir: string, pathExistsFn: (filePath: string) => Promise<boolean>): Promise<string[]>;
-export declare function archiveGoalState(goalId: string, visited: Set<string>, deps: GoalArchiveHelpers): Promise<boolean>;
-//# sourceMappingURL=state-manager-goal-state.d.ts.map

package/dist/base/state/state-manager-goal-state.d.ts.map

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