@nestos/kanban 0.5.1 → 0.5.2

package/dist/execution.cjs

@@ -1,368 +1,18 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } async function _asyncOptionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk4XF6LQSUcjs = require('./chunk-4XF6LQSU.cjs');
 
 
-var _chunk2YFPV5GFcjs = require('./chunk-2YFPV5GF.cjs');
 
 
-var _chunkKYNYPKKHcjs = require('./chunk-KYNYPKKH.cjs');
+var _chunkXBSGUVCYcjs = require('./chunk-XBSGUVCY.cjs');
+require('./chunk-4XF6LQSU.cjs');
+require('./chunk-RSH6QSEC.cjs');
+require('./chunk-AOHQCX7K.cjs');
 
 
 
-var _chunk6MN3H3YFcjs = require('./chunk-6MN3H3YF.cjs');
 
 
-var _chunkLSE6JG5Icjs = require('./chunk-LSE6JG5I.cjs');
 
-// src/execution-bridge.ts
-async function createKanbanExecutionBridge(options) {
-  const path = `${options.directory}/executions.seq`;
-  try {
-    await options.fs.driver.createFile({ parentPath: options.directory, name: "executions.seq", type: "seqfile", recursive: true });
-  } catch (error) {
-    if (_optionalChain([error, 'optionalAccess', _ => _.code]) !== "EEXIST") throw error;
-  }
-  if (!_optionalChain([options, 'access', _2 => _2.fs, 'access', _3 => _3.meta, 'access', _4 => _4.seq, 'optionalAccess', _5 => _5.transaction])) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("TRANSACTION_REQUIRED");
-  let stopped = false, again = false, pending;
-  const writes = /* @__PURE__ */ new Set();
-  const failures = /* @__PURE__ */ new Map();
-  const track = (operation) => {
-    const tracked = operation.finally(() => {
-      writes.delete(tracked);
-    });
-    writes.add(tracked);
-    return tracked;
-  };
-  const active = () => !stopped;
-  const scan = async () => {
-    if (stopped) return;
-    if (pending) {
-      again = true;
-      return pending;
-    }
-    const started = Date.now();
-    pending = runBridge(options, path, active, track, failures).catch((error) => {
-      try {
-        options.log({ operationId: _chunk6MN3H3YFcjs.randomUUID.call(void 0, ), stage: "bridge.scan", result: "failure", code: safeCode(error), durationMs: Date.now() - started });
-      } catch (e) {
-      }
-      throw error;
-    }).finally(() => {
-      pending = void 0;
-      if (again && !stopped) {
-        again = false;
-        void scan().catch(() => {
-        });
-      }
-    });
-    return pending;
-  };
-  const unsubscribe = _optionalChain([options, 'access', _6 => _6.subscribe, 'optionalCall', _7 => _7(() => {
-    void scan().catch(() => {
-    });
-  })]);
-  return { scan, tick: scan, async quiesce() {
-    stopped = true;
-    _optionalChain([unsubscribe, 'optionalCall', _8 => _8()]);
-    if (!pending) return;
-    let timer;
-    try {
-      await Promise.race([pending, new Promise((resolve) => {
-        timer = setTimeout(resolve, _nullishCoalesce(options.shutdownTimeoutMs, () => ( 5e3)));
-      })]);
-    } finally {
-      if (timer) clearTimeout(timer);
-      await Promise.allSettled([...writes]);
-    }
-  } };
-}
-async function runBridge(options, path, active, track, failures) {
-  const workflow = await options.service.workflow(options.boardId);
-  const live = new Set(Object.values(workflow.dispatches).filter((dispatch) => ["prepared", "running", "unknown"].includes(dispatch.outcome)).map((dispatch) => dispatch.id));
-  for (const id of failures.keys()) if (!live.has(id)) failures.delete(id);
-  for (const dispatch of Object.values(workflow.dispatches)) {
-    if (!active()) return;
-    if (live.has(dispatch.id) && (_nullishCoalesce(_optionalChain([failures, 'access', _9 => _9.get, 'call', _10 => _10(dispatch.id), 'optionalAccess', _11 => _11.retryAt]), () => ( 0))) <= Date.now()) await runDispatch(options, path, dispatch, active, track, failures);
-  }
-  const automatic = typeof options.autoDispatch === "function" ? await options.autoDispatch() : options.autoDispatch;
-  if (!automatic || !active()) return;
-  for (const id of (await options.service.workflow(options.boardId)).ready) {
-    if (!active()) return;
-    const { item } = await options.service.item(options.boardId, id), owner = _optionalChain([item, 'access', _12 => _12.eligiblePrincipals, 'optionalAccess', _13 => _13[0]]);
-    if (!owner || !_chunkKYNYPKKHcjs.taskDue.call(void 0, item, (_nullishCoalesce(options.now, () => ( Date.now)))())) continue;
-    const worker = await options.worker(owner), board = await worker.read(options.boardId);
-    if (!active()) return;
-    if (!_chunkLSE6JG5Icjs.boardAllowsStart.call(void 0, board, item)) continue;
-    try {
-      const dispatchId = _chunk6MN3H3YFcjs.randomUUID.call(void 0, );
-      const estimate = await _optionalChain([options, 'access', _14 => _14.estimate, 'optionalCall', _15 => _15(item, owner)]);
-      if (!active()) return;
-      await worker.execute(board.id, { operationId: "dispatch:" + dispatchId, expectedRevision: board.revision, command: { type: "prepare-dispatch", itemId: id, dispatchId, estimate, trigger: "automatic" } });
-      const dispatch = (await options.service.workflow(board.id)).dispatches[dispatchId];
-      if (active()) await runDispatch(options, path, dispatch, active, track, failures);
-    } catch (error) {
-      if (!["WIP_LIMIT", "ASSIGNEE_WIP_LIMIT", "READY_LIMIT", "REVISION_CONFLICT"].includes(safeCode(error))) throw error;
-    }
-  }
-}
-async function runDispatch(options, path, dispatch, active, track, failures) {
-  const start = Date.now();
-  let stage = "inspect", result;
-  const previousFailure = failures.has(dispatch.id);
-  try {
-    let record = await loadRecord(options, path, dispatch);
-    if (!active()) return;
-    if ((!record || record.phase === "prepared") && await _asyncOptionalChain([(await options.service.read(options.boardId)), 'access', async _16 => _16.executionControl, 'optionalAccess', async _17 => _17.paused])) return;
-    if (!record) {
-      stage = "prepare";
-      await options.authorize(stage, dispatch);
-      if (!active()) return;
-      const item = (await options.service.item(options.boardId, dispatch.itemId)).item;
-      if (!active()) return;
-      const request = await prepareRequest(options, path, dispatch, item);
-      if (!active()) return;
-      record = await track(savePrepared(options, path, dispatch, request));
-    }
-    if (!active()) return;
-    const submit = record.phase === "prepared" && await track(claimSubmission(options, path, dispatch));
-    if (!active()) return;
-    stage = submit ? "start" : "inspect";
-    await options.authorize(stage, dispatch);
-    if (!active()) return;
-    result = await (submit ? options.executor.start(record.request) : options.executor.inspect(record.request));
-    failures.delete(dispatch.id);
-  } catch (error) {
-    const notStarted = _optionalChain([error, 'optionalAccess', _18 => _18.executionOutcome]) === "not-started" && error.retryable === true;
-    if (notStarted && stage === "start") await track(releaseUnstartedSubmission(options, path, dispatch));
-    result = { outcome: stage === "prepare" && !notStarted ? "failed" : "unknown", code: safeCode(error) };
-    if (stage === "inspect" || notStarted) {
-      const previous = failures.get(dispatch.id), count = previous && previous.code === result.code ? previous.count + 1 : 1;
-      failures.set(dispatch.id, { code: result.code, count, retryAt: Date.now() + Math.min(6e4, 1e3 * 2 ** Math.min(count - 1, 6)) });
-    }
-  }
-  if (stage !== "inspect" || _chunk4XF6LQSUcjs.executionObservationChanged.call(void 0, dispatch, result) || previousFailure && !failures.has(dispatch.id))
-    try {
-      options.log({ operationId: dispatch.id, stage: `bridge.${stage}`, result: ["unknown", "failed", "cancelled"].includes(result.outcome) ? "failure" : "success", code: result.code, ...failures.has(dispatch.id) ? { retryAfterMs: Math.max(0, failures.get(dispatch.id).retryAt - Date.now()) } : {}, durationMs: Date.now() - start });
-    } catch (e2) {
-    }
-  if (active()) try {
-    await linkSession(options, dispatch, result.executionSessionId);
-    if (active()) await settle(options, dispatch, result);
-  } catch (error) {
-    if (safeCode(error) !== "REVISION_CONFLICT") throw error;
-  }
-}
-async function releaseUnstartedSubmission(options, path, dispatch) {
-  await options.fs.meta.seq.transaction(async (tx) => {
-    const raw = await tx.getEntry(path, dispatch.id);
-    if (!raw) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("EXECUTION_JOURNAL_MISSING");
-    const record = decodeRecord(raw, dispatch);
-    if (record.phase === "submitting") await tx.setEntry(path, dispatch.id, JSON.stringify({ ...record, phase: "prepared" }));
-  });
-}
-async function prepareRequest(options, path, dispatch, item) {
-  if (!dispatch.continuation) return options.executor.prepare(dispatch, item);
-  if (!options.executor.prepareContinuation) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("CONTINUATION_UNSUPPORTED");
-  const previous = (await options.service.workflow(options.boardId)).dispatches[dispatch.continuation.previousDispatchId];
-  if (!previous || previous.itemId !== dispatch.itemId) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("CONTINUATION_SCOPE_MISMATCH");
-  const record = await loadRecord(options, path, previous);
-  if (!record) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("EXECUTION_JOURNAL_MISSING");
-  return options.executor.prepareContinuation(dispatch, item, record.request);
-}
-async function loadRecord(options, path, dispatch) {
-  const raw = await options.fs.meta.seq.getEntry(path, dispatch.id);
-  if (!raw) return;
-  return decodeRecord(raw, dispatch);
-}
-async function savePrepared(options, path, dispatch, request) {
-  const rawRequest = JSON.stringify(request);
-  if (typeof rawRequest !== "string" || new TextEncoder().encode(rawRequest).byteLength > 1024 * 1024) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("INVALID_EXECUTION_REQUEST");
-  return options.fs.meta.seq.transaction(async (tx) => {
-    const raw = await tx.getEntry(path, dispatch.id);
-    if (raw) return decodeRecord(raw, dispatch);
-    const record = { schema: 1, fence: dispatch.fence, request: JSON.parse(rawRequest), digest: _chunk6MN3H3YFcjs.sha256HexSync.call(void 0, rawRequest), phase: "prepared" };
-    await tx.setEntry(path, dispatch.id, JSON.stringify(record));
-    return record;
-  });
-}
-async function claimSubmission(options, path, dispatch) {
-  return options.fs.meta.seq.transaction(async (tx) => {
-    const raw = await tx.getEntry(path, dispatch.id);
-    if (!raw) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("EXECUTION_JOURNAL_MISSING");
-    const record = decodeRecord(raw, dispatch);
-    if (record.phase !== "prepared") return false;
-    await tx.setEntry(path, dispatch.id, JSON.stringify({ ...record, phase: "submitting" }));
-    return true;
-  });
-}
-function decodeRecord(raw, dispatch) {
-  const record = JSON.parse(raw);
-  if (record.schema !== 1 || record.fence !== dispatch.fence || !["prepared", "submitting"].includes(record.phase) || record.digest !== _chunk6MN3H3YFcjs.sha256HexSync.call(void 0, JSON.stringify(record.request))) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("INVALID_EXECUTION_JOURNAL");
-  return record;
-}
-async function settle(options, dispatch, result) {
-  const current = (await options.service.workflow(options.boardId)).dispatches[dispatch.id];
-  if (!current || !["prepared", "running", "unknown"].includes(current.outcome)) return;
-  const board = await options.service.read(options.boardId), item = board.items.find((item2) => item2.id === dispatch.itemId);
-  const renew = ["running", "unknown"].includes(result.outcome) && (_nullishCoalesce(_optionalChain([item, 'optionalAccess', _19 => _19.owner, 'optionalAccess', _20 => _20.leaseUntil]), () => ( 0))) <= Date.now() + board.policy.leaseMs / 2;
-  if (!renew && !_chunk4XF6LQSUcjs.executionObservationChanged.call(void 0, current, result)) return;
-  const { outcome, outputs, code, executionSessionId, controlCapabilities } = result, observation = { outcome, ...controlCapabilities ? { controlCapabilities } : {}, ...executionSessionId ? { executionSessionId } : {}, ...outputs ? { outputs } : {}, ...code ? { code } : {} };
-  const digest = _chunk6MN3H3YFcjs.sha256HexSync.call(void 0, JSON.stringify(observation));
-  await options.service.execute(board.id, {
-    operationId: `settle:${dispatch.id}:${digest}:${board.revision}`,
-    expectedRevision: board.revision,
-    command: { type: "observe-execution", dispatchId: dispatch.id, fence: dispatch.fence, ...observation }
-  });
-}
-async function linkSession(options, dispatch, sessionId) {
-  if (!sessionId || !options.executionReference) return;
-  const reference = options.executionReference(sessionId, dispatch.id);
-  const board = await options.service.read(options.boardId), item = board.items.find((item2) => item2.id === dispatch.itemId);
-  if (_optionalChain([item, 'optionalAccess', _21 => _21.owner, 'optionalAccess', _22 => _22.token]) !== dispatch.fence) throw new (0, _chunk2YFPV5GFcjs.KanbanError)("STALE_EXECUTION_RESULT");
-  const current = _optionalChain([item, 'access', _23 => _23.externalRefs, 'optionalAccess', _24 => _24.filter, 'call', _25 => _25((ref) => ref.system === reference.system), 'access', _26 => _26.at, 'call', _27 => _27(-1)]);
-  if (_optionalChain([current, 'optionalAccess', _28 => _28.id]) === reference.id && current.revision === reference.revision) return;
-  await options.service.execute(board.id, {
-    operationId: `execution-session:${dispatch.id}:${_chunk6MN3H3YFcjs.sha256HexSync.call(void 0, sessionId)}:${board.revision}`,
-    expectedRevision: board.revision,
-    command: { type: "link-reference", itemId: dispatch.itemId, reference }
-  });
-}
-function safeCode(error) {
-  const code = _nullishCoalesce(_optionalChain([error, 'optionalAccess', _29 => _29.reasonCode]), () => ( _optionalChain([error, 'optionalAccess', _30 => _30.code])));
-  return typeof code === "string" && /^[A-Z][A-Z0-9_]{0,79}$/.test(code) ? code : "EXECUTION_OBSERVATION_FAILED";
-}
-
-// src/monitor.ts
-function startKanbanMonitor(options) {
-  let stopped = false, pending;
-  const tick = () => {
-    if (stopped || pending) return;
-    pending = Promise.resolve().then(() => stopped ? void 0 : options.service.scan()).then(() => stopped ? void 0 : _optionalChain([options, 'access', _31 => _31.onSuccess, 'optionalCall', _32 => _32()])).catch(async (error) => {
-      if (stopped) return;
-      try {
-        await options.onError(error);
-      } catch (e3) {
-      }
-    }).finally(() => {
-      pending = void 0;
-    });
-  };
-  const unsubscribe = options.subscribeTick(tick), unwatch = _optionalChain([options, 'access', _33 => _33.subscribeChanges, 'optionalCall', _34 => _34(tick)]);
-  if (options.initialScan !== false) tick();
-  return { async dispose() {
-    if (stopped) {
-      await pending;
-      return;
-    }
-    stopped = true;
-    try {
-      unsubscribe();
-      _optionalChain([unwatch, 'optionalCall', _35 => _35()]);
-    } finally {
-      await pending;
-    }
-  } };
-}
-
-// src/work-messages.ts
-var _vfscore = require('@nestos/vfs-core');
-async function consumeWorkMessages(fs, directory, scope, journal, deliver, decode, publishReply) {
-  const publications = await readPublications(fs, directory, scope, decode), indexKey = "workspace-message-index:" + scope.attemptId;
-  const known = await _asyncNullishCoalesce(await journal.get(indexKey), async () => ( []));
-  if (known.some((id) => !publications.some((p) => p.message.id === id))) throw protocolError("WORK_MESSAGE_MISSING", "Published workspace message is missing", "ECONFLICT");
-  unresolvedWorkIssues(publications.map((p) => p.message));
-  publications.sort((a, b) => Number(a.message.type === "resolved") - Number(b.message.type === "resolved"));
-  for (const { message, bytes } of publications) {
-    const digest = _chunk6MN3H3YFcjs.sha256HexSync.call(void 0, bytes);
-    const delivered = await deliverPublication(journal, indexKey, message, digest, deliver);
-    if (delivered) await publishReply(directory + "/outbox", "ack-" + message.id + ".yaml", JSON.stringify({ schema: "work-reply/1", ...scope, id: "ack-" + message.id, type: "accepted", replyTo: message.id, content: "Accepted", digest }));
-  }
-  return publications.map((p) => p.message);
-}
-async function readPublications(fs, directory, scope, decode) {
-  const files = await fs.driver.getChildren(directory + "/inbox", { fields: "entry" }), publications = [];
-  if (files.length > 200) throw protocolError("WORK_MESSAGE_COUNT_LIMIT", "Workspace inbox exceeds 200 entries");
-  for (const file of files.sort((a, b) => a.name.localeCompare(b.name))) {
-    if (file.type !== "file" || !/^[a-zA-Z0-9_-]{1,128}\.(yaml|yml|json)$/.test(file.name)) continue;
-    const bytes = await readMessageBytes(fs, directory + "/inbox/" + file.name);
-    const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes), envelope = decode(text);
-    if (_optionalChain([envelope, 'optionalAccess', _36 => _36.schema]) === "work-message/2" && Object.hasOwn(envelope, "scopeId")) continue;
-    const message = parseWorkMessage(text, scope, decode);
-    if (file.name.slice(0, file.name.lastIndexOf(".")) !== message.id) throw protocolError("WORK_MESSAGE_FILENAME_MISMATCH", "Workspace message filename does not match its identity");
-    publications.push({ message, bytes });
-  }
-  return publications;
-}
-async function deliverPublication(journal, indexKey, message, digest, deliver) {
-  const key = "workspace-message:" + message.attemptId + ":" + message.id;
-  const receipt = await journal.update(key, (old) => {
-    if (old && old.digest !== digest) throw protocolError("WORK_MESSAGE_CHANGED", "Published workspace message changed", "ECONFLICT");
-    return _nullishCoalesce(old, () => ( { digest, message, delivered: false }));
-  });
-  await journal.update(indexKey, (old) => _optionalChain([old, 'optionalAccess', _37 => _37.includes, 'call', _38 => _38(message.id)]) ? old : [..._nullishCoalesce(old, () => ( [])), message.id]);
-  if (receipt.delivered) return true;
-  const outcome = await deliver(receipt.message);
-  if (_optionalChain([outcome, 'optionalAccess', _39 => _39.pending])) return false;
-  await journal.update(key, (old) => ({ ...old, delivered: true }));
-  return true;
-}
-function parseWorkMessage(text, scope, decode) {
-  let value;
-  try {
-    value = decode(text);
-  } catch (e4) {
-    throw protocolError("WORK_MESSAGE_YAML_INVALID", "Workspace message is not valid bounded YAML");
-  }
-  if (!value || typeof value !== "object" || Array.isArray(value)) throw protocolError("WORK_MESSAGE_SCHEMA_INVALID", "Workspace message schema is invalid");
-  if ("body" in value) {
-    if (Object.hasOwn(value, "content")) throw protocolError("WORK_MESSAGE_FIELDS_INVALID", "Workspace message must not contain both body and content");
-    value = { ...value, content: value.body };
-  }
-  if (Object.keys(value).some((key) => !["schema", "runId", "itemId", "attemptId", "id", "type", "content", "body", "replyTo"].includes(key)))
-    throw protocolError("WORK_MESSAGE_FIELDS_INVALID", "Workspace message contains undeclared fields");
-  validateEnvelope(value, scope);
-  return value;
-}
-function validateEnvelope(value, scope) {
-  if (!["work-message/1", "work-message/2"].includes(value.schema)) throw protocolError("WORK_MESSAGE_SCHEMA_INVALID", "Workspace message schema is unsupported");
-  if (!["progress", "clarification", "error", "result", ...value.schema === "work-message/2" ? ["resolved"] : []].includes(value.type))
-    throw protocolError("WORK_MESSAGE_TYPE_INVALID", "Workspace message schema does not permit this type");
-  if (!validId(value.id)) throw protocolError("WORK_MESSAGE_ID_INVALID", "Workspace message identity is invalid");
-  if (["runId", "itemId", "attemptId"].some((key) => value[key] !== scope[key]))
-    throw protocolError("WORK_MESSAGE_SCOPE_MISMATCH", "Workspace message execution scope is invalid");
-  if (typeof value.content !== "string" || !value.content.trim() || value.content.length > 8e3) throw protocolError("WORK_MESSAGE_CONTENT_INVALID", "Workspace message content is invalid");
-  if (value.replyTo !== void 0 && !validId(value.replyTo) || value.type === "resolved" && !value.replyTo)
-    throw protocolError("WORK_MESSAGE_REPLY_INVALID", "Workspace message reply target is invalid");
-}
-function validId(value) {
-  return typeof value === "string" && /^[a-zA-Z0-9_-]{1,128}$/.test(value);
-}
-function protocolError(reasonCode, message, code = "EINVAL") {
-  return Object.assign(new (0, _vfscore.FSError)(code, message), { reasonCode });
-}
-async function readMessageBytes(fs, path) {
-  const before = await fs.driver.getNode(path);
-  if (_optionalChain([before, 'optionalAccess', _40 => _40.type]) !== "file" || !Number.isSafeInteger(before.size) || before.size < 1) throw protocolError("WORK_MESSAGE_FILE_INVALID", "Workspace message is not a nonempty regular file");
-  if (before.size > 65536) throw protocolError("WORK_MESSAGE_SIZE_LIMIT", "Workspace message exceeds 64 KiB");
-  const bytes = await fs.driver.readContent(path, { encoding: "binary", length: before.size });
-  const after = await fs.driver.getNode(path);
-  if (bytes.byteLength !== before.size || _optionalChain([after, 'optionalAccess', _41 => _41.type]) !== "file" || after.size !== before.size || after.revision !== before.revision || after.modifiedAt !== before.modifiedAt)
-    throw protocolError("WORK_MESSAGE_READ_CONFLICT", "Workspace message changed while reading", "ECONFLICT");
-  return bytes;
-}
-function unresolvedWorkIssues(messages) {
-  const issues = messages.filter((m) => m.type === "clarification" || m.type === "error");
-  for (const resolution of messages.filter((m) => m.type === "resolved")) {
-    if (!issues.some((issue) => issue.id === resolution.replyTo)) throw Object.assign(new Error("Resolution target is not an issue in this attempt"), { code: "WORKSPACE_RESOLUTION_INVALID" });
-  }
-  return issues.filter((issue) => !messages.some((m) => m.type === "resolved" && m.replyTo === issue.id));
-}
-
-
-
-
-
-
-exports.consumeWorkMessages = consumeWorkMessages; exports.createKanbanExecutionBridge = createKanbanExecutionBridge; exports.parseWorkMessage = parseWorkMessage; exports.startKanbanMonitor = startKanbanMonitor; exports.unresolvedWorkIssues = unresolvedWorkIssues;
+exports.consumeWorkMessages = _chunkXBSGUVCYcjs.consumeWorkMessages; exports.createKanbanExecutionBridge = _chunkXBSGUVCYcjs.createKanbanExecutionBridge; exports.parseWorkMessage = _chunkXBSGUVCYcjs.parseWorkMessage; exports.startKanbanMonitor = _chunkXBSGUVCYcjs.startKanbanMonitor; exports.unresolvedWorkIssues = _chunkXBSGUVCYcjs.unresolvedWorkIssues;
 //# sourceMappingURL=execution.cjs.map

package/dist/execution.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/li/share/prj/x1/release/local-libraries/work/1ca933a0-6fe7-4e9c-b13b-76d7f318e0fb/source/libraries/kanban/dist/execution.cjs","../src/execution-bridge.ts","../src/monitor.ts","../src/work-messages.ts"],"names":[],"mappings":"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","file":"/home/li/share/prj/x1/release/local-libraries/work/1ca933a0-6fe7-4e9c-b13b-76d7f318e0fb/source/libraries/kanban/dist/execution.cjs","sourcesContent":[null,"import {boardAllowsStart} from './contracts/board-control';\nimport {taskDue} from './contracts/task-projection';\nimport {sha256HexSync, randomUUID} from './utils';\nimport type {IFileSystem} from '@nestos/vfs-core';\nimport type {KanbanDispatch, KanbanService, KanbanItem, KanbanArtifactRef, KanbanPrincipal, KanbanEstimate} from './contracts';\nimport {KanbanError} from './ports';\nimport {executionObservationChanged} from './execution-observation';\n\nexport interface KanbanExecutionObservation {\n    controlCapabilities?: {pause:'boundary'|'none';resume:boolean};\n    executionSessionId?: string;\n    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';\n    outputs?: KanbanArtifactRef[]; code?: string;\n}\nexport interface KanbanExecutionPort {\n    prepareContinuation?(dispatch: KanbanDispatch, item: KanbanItem, previousRequest: unknown): Promise<unknown>;\n    /** Persistable request; preparing cannot submit agent work. */\n    prepare(dispatch: KanbanDispatch, item: KanbanItem): Promise<unknown>;\n    start(request: unknown): Promise<KanbanExecutionObservation>;\n    /** Observe the original admission only. Missing receipts mean unknown. */\n    inspect(request: unknown): Promise<KanbanExecutionObservation>;\n}\nexport interface KanbanExecutionBridgeOptions {\n    fs: IFileSystem; directory: string; boardId: string; service: KanbanService;\n    worker(principal: KanbanPrincipal): Promise<KanbanService>;\n    executor: KanbanExecutionPort;\n    authorize(stage: 'prepare' | 'start' | 'inspect', dispatch: KanbanDispatch): Promise<void>;\n    log(input: {operationId: string; stage: string; result: 'success' | 'failure'; code?: string; retryAfterMs?: number; durationMs: number}): void;\n    executionReference?(sessionId: string, dispatchId: string): import('./contracts').KanbanExternalReference;\n    subscribe?(wake: () => void): () => void;\n    now?:()=>number;\n    autoDispatch?: boolean | (() => Promise<boolean>); shutdownTimeoutMs?: number;\n    estimate?(item: KanbanItem, principal: KanbanPrincipal): Promise<KanbanEstimate | undefined>;\n}\ninterface ExecutionRecord {schema: 1; fence: string; request: unknown; digest: string; phase: 'prepared' | 'submitting'}\ninterface ReadFailure {code: string; count: number; retryAt: number}\ntype TrackWrite = <T>(operation: Promise<T>) => Promise<T>;\n\n/** The host owns execution. Prepared/submitting identities survive response loss and host shutdown. */\nexport async function createKanbanExecutionBridge(options: KanbanExecutionBridgeOptions) {\n    const path = `${options.directory}/executions.seq`;\n    try {await options.fs.driver.createFile({parentPath:options.directory,name:'executions.seq',type:'seqfile',recursive:true});}\n    catch(error) {if((error as {code?:string})?.code!=='EEXIST') throw error;}\n    if(!options.fs.meta.seq?.transaction) throw new KanbanError('TRANSACTION_REQUIRED');\n    let stopped=false, again=false, pending: Promise<void>|undefined;\n    const writes=new Set<Promise<unknown>>();\n    const failures = new Map<string, ReadFailure>();\n    const track:TrackWrite=operation=>{const tracked=operation.finally(()=>{writes.delete(tracked);});writes.add(tracked);return tracked;};\n    const active=()=>!stopped;\n    const scan=async()=>{if(stopped) return; if(pending) {again=true; return pending;} const started=Date.now();\n        pending=runBridge(options,path,active,track,failures).catch(error=>{try {options.log({operationId:randomUUID(),stage:'bridge.scan',result:'failure',code:safeCode(error),durationMs:Date.now()-started});} catch {/* Diagnostics cannot replay work. */} throw error;}).finally(()=>{pending=undefined;if(again&&!stopped) {again=false;void scan().catch(()=>{});}});\n        return pending;\n    };\n    const unsubscribe=options.subscribe?.(()=>{void scan().catch(()=>{});});\n    return {scan, tick: scan, async quiesce() {\n        stopped=true;unsubscribe?.(); if(!pending) return;\n        let timer: ReturnType<typeof setTimeout>|undefined;\n        try {await Promise.race([pending,new Promise<void>(resolve=>{timer=setTimeout(resolve,options.shutdownTimeoutMs ?? 5000);})]);}\n        finally {if(timer) clearTimeout(timer);await Promise.allSettled([...writes]);}\n    }};\n}\nasync function runBridge(options: KanbanExecutionBridgeOptions, path: string, active: () => boolean, track: TrackWrite, failures: Map<string, ReadFailure>): Promise<void> {\n    const workflow=await options.service.workflow(options.boardId);\n    const live = new Set(Object.values(workflow.dispatches).filter(dispatch => ['prepared', 'running', 'unknown'].includes(dispatch.outcome)).map(dispatch => dispatch.id));\n    for (const id of failures.keys()) if (!live.has(id)) failures.delete(id);\n    for(const dispatch of Object.values(workflow.dispatches)) {\n        if(!active()) return;\n        if(live.has(dispatch.id) && (failures.get(dispatch.id)?.retryAt ?? 0) <= Date.now()) await runDispatch(options,path,dispatch,active,track,failures);\n    }\n    const automatic = typeof options.autoDispatch === 'function' ? await options.autoDispatch() : options.autoDispatch;\n    if(!automatic||!active()) return;\n    for(const id of (await options.service.workflow(options.boardId)).ready) {\n        if(!active()) return;\n        const {item}=await options.service.item(options.boardId,id), owner=item.eligiblePrincipals?.[0]; if(!owner || !taskDue(item, (options.now??Date.now)())) continue;\n        const worker=await options.worker(owner), board=await worker.read(options.boardId);if(!active()) return;\n        if (!boardAllowsStart(board, item)) continue;\n        try {\n            const dispatchId=randomUUID();\n            const estimate=await options.estimate?.(item,owner);if(!active()) return;\n            await worker.execute(board.id,{operationId:'dispatch:'+dispatchId,expectedRevision:board.revision,command:{type:'prepare-dispatch',itemId:id,dispatchId,estimate,trigger:'automatic'}});\n            const dispatch=(await options.service.workflow(board.id)).dispatches[dispatchId];\n            if(active()) await runDispatch(options,path,dispatch,active,track,failures);\n        }\n        catch(error) {if(!['WIP_LIMIT','ASSIGNEE_WIP_LIMIT','READY_LIMIT','REVISION_CONFLICT'].includes(safeCode(error))) throw error;}\n    }\n}\nasync function runDispatch(options: KanbanExecutionBridgeOptions, path: string, dispatch: KanbanDispatch, active: () => boolean, track: TrackWrite, failures: Map<string, ReadFailure>): Promise<void> {\n    const start=Date.now(); let stage: 'inspect' | 'prepare' | 'start'='inspect', result: KanbanExecutionObservation;\n    const previousFailure = failures.has(dispatch.id);\n    try {\n        let record=await loadRecord(options,path,dispatch);if(!active()) return;\n        if ((!record || record.phase === 'prepared') && (await options.service.read(options.boardId)).executionControl?.paused) return;\n        if(!record) {\n            stage='prepare';await options.authorize(stage,dispatch);if(!active()) return;\n            const item=(await options.service.item(options.boardId,dispatch.itemId)).item;if(!active()) return;\n            const request=await prepareRequest(options, path, dispatch, item);if(!active()) return;\n            record=await track(savePrepared(options,path,dispatch,request));\n        }\n        if(!active()) return;\n        const submit=record.phase==='prepared'&&await track(claimSubmission(options,path,dispatch));\n        if(!active()) return; stage=submit?'start':'inspect';await options.authorize(stage,dispatch);if(!active()) return;\n        result=await (submit?options.executor.start(record.request):options.executor.inspect(record.request));\n        failures.delete(dispatch.id);\n    } catch(error) {\n        const notStarted = (error as {executionOutcome?: string; retryable?: boolean})?.executionOutcome === 'not-started'\n            && (error as {retryable?: boolean}).retryable === true;\n        if (notStarted && stage === 'start') await track(releaseUnstartedSubmission(options, path, dispatch));\n        result={outcome:stage==='prepare'&&!notStarted?'failed':'unknown',code:safeCode(error)};\n        if (stage === 'inspect' || notStarted) {\n            const previous = failures.get(dispatch.id), count = previous && previous.code === result.code ? previous.count + 1 : 1;\n            failures.set(dispatch.id, {code: result.code!, count, retryAt: Date.now() + Math.min(60000, 1000 * 2 ** Math.min(count - 1, 6))});\n        }\n    }\n    if (stage !== 'inspect' || executionObservationChanged(dispatch, result) || previousFailure && !failures.has(dispatch.id))\n        try {options.log({operationId:dispatch.id,stage:`bridge.${stage}`,result:['unknown','failed','cancelled'].includes(result.outcome)?'failure':'success',code:result.code,...(failures.has(dispatch.id)?{retryAfterMs:Math.max(0,failures.get(dispatch.id)!.retryAt-Date.now())}:{}),durationMs:Date.now()-start});} catch {/* Metadata-only diagnostics. */}\n    if(active()) try {await linkSession(options,dispatch,result.executionSessionId);if(active()) await settle(options,dispatch,result);} catch(error) {if(safeCode(error)!=='REVISION_CONFLICT') throw error;}\n}\nasync function releaseUnstartedSubmission(options: KanbanExecutionBridgeOptions, path: string, dispatch: KanbanDispatch): Promise<void> {\n    await options.fs.meta.seq!.transaction!(async tx => {\n        const raw = await tx.getEntry(path, dispatch.id);\n        if (!raw) throw new KanbanError('EXECUTION_JOURNAL_MISSING');\n        const record = decodeRecord(raw, dispatch);\n        if (record.phase === 'submitting') await tx.setEntry(path, dispatch.id, JSON.stringify({...record, phase: 'prepared'}));\n    });\n}\nasync function prepareRequest(options: KanbanExecutionBridgeOptions, path: string, dispatch: KanbanDispatch, item: KanbanItem): Promise<unknown> {\n    if (!dispatch.continuation) return options.executor.prepare(dispatch, item);\n    if (!options.executor.prepareContinuation) throw new KanbanError('CONTINUATION_UNSUPPORTED');\n    const previous = (await options.service.workflow(options.boardId)).dispatches[dispatch.continuation.previousDispatchId];\n    if (!previous || previous.itemId !== dispatch.itemId) throw new KanbanError('CONTINUATION_SCOPE_MISMATCH');\n    const record = await loadRecord(options, path, previous);\n    if (!record) throw new KanbanError('EXECUTION_JOURNAL_MISSING');\n    return options.executor.prepareContinuation(dispatch, item, record.request);\n}\nasync function loadRecord(options: KanbanExecutionBridgeOptions, path: string, dispatch: KanbanDispatch): Promise<ExecutionRecord|undefined> {\n    const raw=await options.fs.meta.seq!.getEntry(path,dispatch.id); if(!raw) return;\n    return decodeRecord(raw,dispatch);\n}\nasync function savePrepared(options: KanbanExecutionBridgeOptions, path: string, dispatch: KanbanDispatch, request: unknown): Promise<ExecutionRecord> {\n    const rawRequest=JSON.stringify(request);\n    if(typeof rawRequest!=='string'||new TextEncoder().encode(rawRequest).byteLength>1024*1024) throw new KanbanError('INVALID_EXECUTION_REQUEST');\n    return options.fs.meta.seq!.transaction!(async tx=>{\n        const raw=await tx.getEntry(path,dispatch.id);if(raw) return decodeRecord(raw,dispatch);\n        const record: ExecutionRecord={schema:1,fence:dispatch.fence,request:JSON.parse(rawRequest),digest:sha256HexSync(rawRequest),phase:'prepared'};\n        await tx.setEntry(path,dispatch.id,JSON.stringify(record));return record;\n    });\n}\nasync function claimSubmission(options: KanbanExecutionBridgeOptions, path: string, dispatch: KanbanDispatch): Promise<boolean> {\n    return options.fs.meta.seq!.transaction!(async tx=>{\n        const raw=await tx.getEntry(path,dispatch.id);if(!raw) throw new KanbanError('EXECUTION_JOURNAL_MISSING');\n        const record=decodeRecord(raw,dispatch);\n        if(record.phase!=='prepared') return false;\n        await tx.setEntry(path,dispatch.id,JSON.stringify({...record,phase:'submitting'}));return true;\n    });\n}\nfunction decodeRecord(raw: string, dispatch: KanbanDispatch): ExecutionRecord {\n    const record=JSON.parse(raw) as ExecutionRecord;\n    if(record.schema!==1||record.fence!==dispatch.fence||!['prepared','submitting'].includes(record.phase)||record.digest!==sha256HexSync(JSON.stringify(record.request))) throw new KanbanError('INVALID_EXECUTION_JOURNAL');return record;\n}\nasync function settle(options: KanbanExecutionBridgeOptions, dispatch: KanbanDispatch, result: KanbanExecutionObservation): Promise<void> {\n    const current=(await options.service.workflow(options.boardId)).dispatches[dispatch.id];\n    if(!current||!['prepared','running','unknown'].includes(current.outcome)) return;\n    const board=await options.service.read(options.boardId), item=board.items.find(item=>item.id===dispatch.itemId);\n    const renew=['running','unknown'].includes(result.outcome) && (item?.owner?.leaseUntil ?? 0) <= Date.now() + board.policy.leaseMs / 2;\n    if(!renew&&!executionObservationChanged(current,result)) return;\n    const {outcome,outputs,code,executionSessionId,controlCapabilities}=result, observation={outcome,...(controlCapabilities?{controlCapabilities}:{}),...(executionSessionId?{executionSessionId}:{}),...(outputs?{outputs}:{}),...(code?{code}:{})};\n    const digest=sha256HexSync(JSON.stringify(observation));\n    await options.service.execute(board.id,{operationId:`settle:${dispatch.id}:${digest}:${board.revision}`,expectedRevision:board.revision,\n        command:{type:'observe-execution',dispatchId:dispatch.id,fence:dispatch.fence,...observation}});\n}\nasync function linkSession(options: KanbanExecutionBridgeOptions, dispatch: KanbanDispatch, sessionId?: string): Promise<void> {\n    if(!sessionId || !options.executionReference) return;\n    const reference = options.executionReference(sessionId, dispatch.id);\n    const board=await options.service.read(options.boardId),item=board.items.find(item=>item.id===dispatch.itemId);\n    if(item?.owner?.token!==dispatch.fence) throw new KanbanError('STALE_EXECUTION_RESULT');\n    const current=item.externalRefs?.filter(ref=>ref.system===reference.system).at(-1);\n    if(current?.id===reference.id&&current.revision===reference.revision) return;\n    await options.service.execute(board.id,{operationId:`execution-session:${dispatch.id}:${sha256HexSync(sessionId)}:${board.revision}`,expectedRevision:board.revision,\n        command:{type:'link-reference',itemId:dispatch.itemId,reference}});\n}\nfunction safeCode(error: unknown): string {\n    const code=(error as {reasonCode?:unknown})?.reasonCode??(error as {code?:unknown})?.code;return typeof code==='string'&&/^[A-Z][A-Z0-9_]{0,79}$/.test(code)?code:'EXECUTION_OBSERVATION_FAILED';\n}\n","import type {KanbanClient} from './contracts';\n\n/** Host supplies its scheduler; disposal prevents new scans and awaits in-flight work. */\nexport function startKanbanMonitor(options: {\n    service: Pick<KanbanClient, 'scan'>;\n    subscribeTick: (tick: () => void) => () => void;\n    onError: (error: unknown) => void | Promise<void>;\n    onSuccess?: () => void | Promise<void>;\n    subscribeChanges?: (tick: () => void) => () => void;\n    initialScan?: boolean;\n}): { dispose(): Promise<void> } {\n    let stopped = false, pending: Promise<void> | undefined;\n    const tick = () => {\n        if (stopped || pending) return;\n        pending = Promise.resolve().then(() => stopped ? undefined : options.service.scan()).then(()=>stopped ? undefined : options.onSuccess?.()).catch(async error => {\n            if (stopped) return;\n            try { await options.onError(error); } catch { /* Reporting must not leave an unhandled rejection. */ }\n        }).finally(() => { pending = undefined; });\n    };\n    const unsubscribe = options.subscribeTick(tick), unwatch = options.subscribeChanges?.(tick);\n    if (options.initialScan !== false) tick();\n    return { async dispose() {\n        if (stopped) { await pending; return; }\n        stopped = true; try { unsubscribe(); unwatch?.(); } finally { await pending; }\n    } };\n}\n","import {FSError, type IFileSystem} from '@nestos/vfs-core';\nimport {sha256HexSync} from './utils';\nexport interface WorkMessageScope {runId:string;itemId:string;attemptId:string}\nexport interface WorkMessage extends WorkMessageScope {schema:'work-message/1'|'work-message/2';id:string;type:'progress'|'clarification'|'error'|'result'|'resolved';content:string;replyTo?:string}\ninterface Journal {get<T>(key:string):Promise<T|undefined>;update<T>(key:string,change:(old:T|undefined)=>T):Promise<T>}\ninterface Receipt {digest:string;message:WorkMessage;delivered:boolean}\n/** Directory events are wakeups; immutable files plus durable receipts are authoritative. */\nexport async function consumeWorkMessages(fs:IFileSystem,directory:string,scope:WorkMessageScope,journal:Journal,\n    deliver:(message:WorkMessage)=>Promise<void|{pending:true}>,decode:(text:string)=>unknown,publishReply:(directory:string,name:string,content:string)=>Promise<void>):Promise<WorkMessage[]> {\n    const publications=await readPublications(fs,directory,scope,decode),indexKey='workspace-message-index:'+scope.attemptId;\n    const known=await journal.get<string[]>(indexKey)??[];\n    if(known.some(id=>!publications.some(p=>p.message.id===id)))throw protocolError('WORK_MESSAGE_MISSING','Published workspace message is missing','ECONFLICT');\n    unresolvedWorkIssues(publications.map(p=>p.message));\n    publications.sort((a,b)=>Number(a.message.type==='resolved')-Number(b.message.type==='resolved'));\n    for(const {message,bytes} of publications) {\n        const digest=sha256HexSync(bytes);\n        const delivered=await deliverPublication(journal,indexKey,message,digest,deliver);\n        if(delivered)await publishReply(directory+'/outbox','ack-'+message.id+'.yaml',JSON.stringify({schema:'work-reply/1',...scope,id:'ack-'+message.id,type:'accepted',replyTo:message.id,content:'Accepted',digest}));\n    }\n    return publications.map(p=>p.message);\n}\nasync function readPublications(fs:IFileSystem,directory:string,scope:WorkMessageScope,decode:(text:string)=>unknown) {\n    const files=await fs.driver.getChildren(directory+'/inbox',{fields:'entry'}),publications:Array<{message:WorkMessage;bytes:ArrayBuffer}>=[];\n    if(files.length>200)throw protocolError('WORK_MESSAGE_COUNT_LIMIT','Workspace inbox exceeds 200 entries');\n    for(const file of files.sort((a,b)=>a.name.localeCompare(b.name))) {\n        if(file.type!=='file'||!/^[a-zA-Z0-9_-]{1,128}\\.(yaml|yml|json)$/.test(file.name))continue;\n        const bytes=await readMessageBytes(fs,directory+'/inbox/'+file.name);\n        const text = new TextDecoder('utf-8',{fatal:true}).decode(bytes), envelope = decode(text) as {schema?: string; scopeId?: string};\n        if (envelope?.schema === 'work-message/2' && Object.hasOwn(envelope, 'scopeId')) continue;\n        const message=parseWorkMessage(text,scope,decode);\n        if(file.name.slice(0,file.name.lastIndexOf('.'))!==message.id)throw protocolError('WORK_MESSAGE_FILENAME_MISMATCH','Workspace message filename does not match its identity');\n        publications.push({message,bytes});\n    }\n    return publications;\n}\nasync function deliverPublication(journal:Journal,indexKey:string,message:WorkMessage,digest:string,deliver:(message:WorkMessage)=>Promise<void|{pending:true}>):Promise<boolean> {\n    const key='workspace-message:'+message.attemptId+':'+message.id;\n    const receipt=await journal.update<Receipt>(key,old=>{\n        if(old&&old.digest!==digest)throw protocolError('WORK_MESSAGE_CHANGED','Published workspace message changed','ECONFLICT');\n        return old??{digest,message,delivered:false};\n    });\n    await journal.update<string[]>(indexKey,old=>old?.includes(message.id)?old:[...old??[],message.id]);\n    if(receipt.delivered)return true;\n    const outcome=await deliver(receipt.message);if(outcome?.pending)return false;\n    await journal.update<Receipt>(key,old=>({...old!,delivered:true}));return true;\n}\n\nexport function parseWorkMessage(text:string,scope:WorkMessageScope,decode:(text:string)=>unknown):WorkMessage {\n    let value:WorkMessage;\n    try {value=decode(text) as WorkMessage;} catch {throw protocolError('WORK_MESSAGE_YAML_INVALID','Workspace message is not valid bounded YAML');}\n    if(!value||typeof value!=='object'||Array.isArray(value))throw protocolError('WORK_MESSAGE_SCHEMA_INVALID','Workspace message schema is invalid');\n    if('body' in value) {\n        if(Object.hasOwn(value,'content'))throw protocolError('WORK_MESSAGE_FIELDS_INVALID','Workspace message must not contain both body and content');\n        value={...value,content:(value as WorkMessage&{body:string}).body};\n    }\n    if(Object.keys(value).some(key=>!['schema','runId','itemId','attemptId','id','type','content','body','replyTo'].includes(key)))\n        throw protocolError('WORK_MESSAGE_FIELDS_INVALID','Workspace message contains undeclared fields');\n    validateEnvelope(value,scope);return value;\n}\nfunction validateEnvelope(value:WorkMessage,scope:WorkMessageScope):void {\n    if(!['work-message/1','work-message/2'].includes(value.schema))throw protocolError('WORK_MESSAGE_SCHEMA_INVALID','Workspace message schema is unsupported');\n    if(!['progress','clarification','error','result',...(value.schema==='work-message/2'?['resolved']:[])].includes(value.type))\n        throw protocolError('WORK_MESSAGE_TYPE_INVALID','Workspace message schema does not permit this type');\n    if(!validId(value.id))throw protocolError('WORK_MESSAGE_ID_INVALID','Workspace message identity is invalid');\n    if(['runId','itemId','attemptId'].some(key=>value[key as keyof WorkMessageScope]!==scope[key as keyof WorkMessageScope]))\n        throw protocolError('WORK_MESSAGE_SCOPE_MISMATCH','Workspace message execution scope is invalid');\n    if(typeof value.content!=='string'||!value.content.trim()||value.content.length>8000)throw protocolError('WORK_MESSAGE_CONTENT_INVALID','Workspace message content is invalid');\n    if(value.replyTo!==undefined&&!validId(value.replyTo)||value.type==='resolved'&&!value.replyTo)\n        throw protocolError('WORK_MESSAGE_REPLY_INVALID','Workspace message reply target is invalid');\n}\nfunction validId(value:unknown):value is string {return typeof value==='string'&&/^[a-zA-Z0-9_-]{1,128}$/.test(value);}\nfunction protocolError(reasonCode:string,message:string,code:'EINVAL'|'ECONFLICT'='EINVAL'):Error {\n    return Object.assign(new FSError(code,message),{reasonCode});\n}\n\n/** Range reads must fit the advertised size; remote backends reject short ranges. */\nasync function readMessageBytes(fs: IFileSystem, path: string): Promise<ArrayBuffer> {\n    const before = await fs.driver.getNode(path);\n    if (before?.type !== 'file' || !Number.isSafeInteger(before.size) || before.size < 1) throw protocolError('WORK_MESSAGE_FILE_INVALID','Workspace message is not a nonempty regular file');\n    if (before.size > 65536) throw protocolError('WORK_MESSAGE_SIZE_LIMIT','Workspace message exceeds 64 KiB');\n    const bytes = await fs.driver.readContent(path, {encoding: 'binary', length: before.size});\n    const after = await fs.driver.getNode(path);\n    if (bytes.byteLength !== before.size || after?.type !== 'file' || after.size !== before.size\n        || after.revision !== before.revision || after.modifiedAt !== before.modifiedAt)\n        throw protocolError('WORK_MESSAGE_READ_CONFLICT','Workspace message changed while reading','ECONFLICT');\n    return bytes;\n}\n\n/** Only explicit linked resolutions close issues; unrelated progress cannot erase them. */\nexport function unresolvedWorkIssues(messages: WorkMessage[]): WorkMessage[] {\n    const issues = messages.filter(m => m.type === 'clarification' || m.type === 'error');\n    for (const resolution of messages.filter(m => m.type === 'resolved')) {\n        if (!issues.some(issue => issue.id === resolution.replyTo)) throw Object.assign(new Error('Resolution target is not an issue in this attempt'), {code:'WORKSPACE_RESOLUTION_INVALID'});\n    }\n    return issues.filter(issue => !messages.some(m => m.type === 'resolved' && m.replyTo === issue.id));\n}\n"]}
+{"version":3,"sources":["/home/li/share/prj/x1/libraries/kanban/dist/execution.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACF,kWAAC","file":"/home/li/share/prj/x1/libraries/kanban/dist/execution.cjs"}

package/dist/execution.d.cts

@@ -1,54 +1,7 @@
-import { T as KanbanService, I as KanbanPrincipal, r as KanbanDispatch, w as KanbanItem, d as KanbanArtifactRef, u as KanbanExternalReference, s as KanbanEstimate } from './planning-CcFZYdIL.cjs';
+export { K as KanbanExecutionBridgeOptions, a as KanbanExecutionObservation, b as KanbanExecutionPort, c as createKanbanExecutionBridge } from './execution-bridge-fpCnH6z5.cjs';
+import { K as KanbanClient } from './activity-BbC4sgKL.cjs';
 import { IFileSystem } from '@nestos/vfs-core';
-import { K as KanbanClient } from './activity-C6xDM-cg.cjs';
-
-interface KanbanExecutionObservation {
-    controlCapabilities?: {
-        pause: 'boundary' | 'none';
-        resume: boolean;
-    };
-    executionSessionId?: string;
-    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';
-    outputs?: KanbanArtifactRef[];
-    code?: string;
-}
-interface KanbanExecutionPort {
-    prepareContinuation?(dispatch: KanbanDispatch, item: KanbanItem, previousRequest: unknown): Promise<unknown>;
-    /** Persistable request; preparing cannot submit agent work. */
-    prepare(dispatch: KanbanDispatch, item: KanbanItem): Promise<unknown>;
-    start(request: unknown): Promise<KanbanExecutionObservation>;
-    /** Observe the original admission only. Missing receipts mean unknown. */
-    inspect(request: unknown): Promise<KanbanExecutionObservation>;
-}
-interface KanbanExecutionBridgeOptions {
-    fs: IFileSystem;
-    directory: string;
-    boardId: string;
-    service: KanbanService;
-    worker(principal: KanbanPrincipal): Promise<KanbanService>;
-    executor: KanbanExecutionPort;
-    authorize(stage: 'prepare' | 'start' | 'inspect', dispatch: KanbanDispatch): Promise<void>;
-    log(input: {
-        operationId: string;
-        stage: string;
-        result: 'success' | 'failure';
-        code?: string;
-        retryAfterMs?: number;
-        durationMs: number;
-    }): void;
-    executionReference?(sessionId: string, dispatchId: string): KanbanExternalReference;
-    subscribe?(wake: () => void): () => void;
-    now?: () => number;
-    autoDispatch?: boolean | (() => Promise<boolean>);
-    shutdownTimeoutMs?: number;
-    estimate?(item: KanbanItem, principal: KanbanPrincipal): Promise<KanbanEstimate | undefined>;
-}
-/** The host owns execution. Prepared/submitting identities survive response loss and host shutdown. */
-declare function createKanbanExecutionBridge(options: KanbanExecutionBridgeOptions): Promise<{
-    scan: () => Promise<void>;
-    tick: () => Promise<void>;
-    quiesce(): Promise<void>;
-}>;
+import './planning-CHrOqQ6b.cjs';
 
 /** Host supplies its scheduler; disposal prevents new scans and awaits in-flight work. */
 declare function startKanbanMonitor(options: {
@@ -86,4 +39,4 @@ declare function parseWorkMessage(text: string, scope: WorkMessageScope, decode:
 /** Only explicit linked resolutions close issues; unrelated progress cannot erase them. */
 declare function unresolvedWorkIssues(messages: WorkMessage[]): WorkMessage[];
 
-export { type KanbanExecutionBridgeOptions, type KanbanExecutionObservation, type KanbanExecutionPort, type WorkMessage, type WorkMessageScope, consumeWorkMessages, createKanbanExecutionBridge, parseWorkMessage, startKanbanMonitor, unresolvedWorkIssues };
+export { type WorkMessage, type WorkMessageScope, consumeWorkMessages, parseWorkMessage, startKanbanMonitor, unresolvedWorkIssues };

package/dist/execution.d.ts

@@ -1,54 +1,7 @@
-import { T as KanbanService, I as KanbanPrincipal, r as KanbanDispatch, w as KanbanItem, d as KanbanArtifactRef, u as KanbanExternalReference, s as KanbanEstimate } from './planning-CcFZYdIL.js';
+export { K as KanbanExecutionBridgeOptions, a as KanbanExecutionObservation, b as KanbanExecutionPort, c as createKanbanExecutionBridge } from './execution-bridge-rk0uVy_n.js';
+import { K as KanbanClient } from './activity-Czlan5xW.js';
 import { IFileSystem } from '@nestos/vfs-core';
-import { K as KanbanClient } from './activity-Dw8DOw0L.js';
-
-interface KanbanExecutionObservation {
-    controlCapabilities?: {
-        pause: 'boundary' | 'none';
-        resume: boolean;
-    };
-    executionSessionId?: string;
-    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';
-    outputs?: KanbanArtifactRef[];
-    code?: string;
-}
-interface KanbanExecutionPort {
-    prepareContinuation?(dispatch: KanbanDispatch, item: KanbanItem, previousRequest: unknown): Promise<unknown>;
-    /** Persistable request; preparing cannot submit agent work. */
-    prepare(dispatch: KanbanDispatch, item: KanbanItem): Promise<unknown>;
-    start(request: unknown): Promise<KanbanExecutionObservation>;
-    /** Observe the original admission only. Missing receipts mean unknown. */
-    inspect(request: unknown): Promise<KanbanExecutionObservation>;
-}
-interface KanbanExecutionBridgeOptions {
-    fs: IFileSystem;
-    directory: string;
-    boardId: string;
-    service: KanbanService;
-    worker(principal: KanbanPrincipal): Promise<KanbanService>;
-    executor: KanbanExecutionPort;
-    authorize(stage: 'prepare' | 'start' | 'inspect', dispatch: KanbanDispatch): Promise<void>;
-    log(input: {
-        operationId: string;
-        stage: string;
-        result: 'success' | 'failure';
-        code?: string;
-        retryAfterMs?: number;
-        durationMs: number;
-    }): void;
-    executionReference?(sessionId: string, dispatchId: string): KanbanExternalReference;
-    subscribe?(wake: () => void): () => void;
-    now?: () => number;
-    autoDispatch?: boolean | (() => Promise<boolean>);
-    shutdownTimeoutMs?: number;
-    estimate?(item: KanbanItem, principal: KanbanPrincipal): Promise<KanbanEstimate | undefined>;
-}
-/** The host owns execution. Prepared/submitting identities survive response loss and host shutdown. */
-declare function createKanbanExecutionBridge(options: KanbanExecutionBridgeOptions): Promise<{
-    scan: () => Promise<void>;
-    tick: () => Promise<void>;
-    quiesce(): Promise<void>;
-}>;
+import './planning-CHrOqQ6b.js';
 
 /** Host supplies its scheduler; disposal prevents new scans and awaits in-flight work. */
 declare function startKanbanMonitor(options: {
@@ -86,4 +39,4 @@ declare function parseWorkMessage(text: string, scope: WorkMessageScope, decode:
 /** Only explicit linked resolutions close issues; unrelated progress cannot erase them. */
 declare function unresolvedWorkIssues(messages: WorkMessage[]): WorkMessage[];
 
-export { type KanbanExecutionBridgeOptions, type KanbanExecutionObservation, type KanbanExecutionPort, type WorkMessage, type WorkMessageScope, consumeWorkMessages, createKanbanExecutionBridge, parseWorkMessage, startKanbanMonitor, unresolvedWorkIssues };
+export { type WorkMessage, type WorkMessageScope, consumeWorkMessages, parseWorkMessage, startKanbanMonitor, unresolvedWorkIssues };