@north-light/crouter 0.3.318 → 0.3.319

package/dist/daemon/api/handlers/human-requests.js

@@ -1,379 +1 @@
-import { statSync } from 'node:fs';
-import { isAbsolute } from 'node:path';
-import { ApiError } from '../../../api/index.js';
-import { readExternalActionDelivery } from '../../../core/canvas/deliveries.js';
-import { isSafeNodeId } from '../../../core/canvas/paths.js';
-import { resolvePageComponents } from '../../../core/config.js';
-import { resolveHumanAction } from '../../../core/human-actions.js';
-import { HUMAN_ACTION_NAME_PATTERN } from '../../../core/human/action-binding.js';
-import { createPageRequest, getRequest } from '../../../core/human/requests.js';
-import { preparePageSource } from '../../../core/human/page-authoring.js';
-import { publishPage, validatePageTicketResponses } from '../../../core/human/tickets.js';
-import { cancelHumanTicket, resolvePageTicket } from '../../human/finish.js';
-import { inboxPageProjection } from './inbox-page.js';
-const REASON_MAX = 1000;
-const ACTOR_MAX = 200;
-const DEFAULT_DELIVERY = { placement: 'inline', inbox: true, reply: false };
-const SOURCE_FIELDS = ['sessionName', 'askedBy', 'emittedAt', 'profileName', 'nodeId'];
-function isPlainObject(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function requireNoExtraKeys(obj, allowed, where) {
-    for (const key of Object.keys(obj)) {
-        if (!allowed.includes(key))
-            throw new ApiError(400, 'invalid_request', `unexpected field in ${where}: ${key}`);
-    }
-}
-function invalid(message) { return new ApiError(400, 'invalid_request', message); }
-function validatePage(raw) {
-    if (!isPlainObject(raw))
-        throw invalid('`page` must be an object');
-    requireNoExtraKeys(raw, ['dialect', 'source'], '`page`');
-    if (raw['dialect'] !== 'jsx' && raw['dialect'] !== 'html')
-        throw invalid('`page.dialect` must be "jsx" or "html"');
-    if (typeof raw['source'] !== 'string' || raw['source'].trim() === '')
-        throw invalid('`page.source` must be the authored page text');
-    return { dialect: raw['dialect'], source: raw['source'] };
-}
-function validatePlacement(raw, fallback) {
-    const placement = raw ?? fallback;
-    if (placement !== 'inline' && placement !== 'panel')
-        throw invalid('`delivery.placement` must be "inline" or "panel"');
-    return placement;
-}
-function validateCreateDelivery(raw, requesterNodeId) {
-    if (raw === undefined)
-        return DEFAULT_DELIVERY;
-    if (!isPlainObject(raw))
-        throw invalid('`delivery` must be an object');
-    requireNoExtraKeys(raw, ['placement', 'inbox', 'reply'], '`delivery`');
-    const inbox = raw['inbox'] ?? DEFAULT_DELIVERY.inbox;
-    const reply = raw['reply'] ?? DEFAULT_DELIVERY.reply;
-    if (typeof inbox !== 'boolean')
-        throw invalid('`delivery.inbox` must be boolean');
-    if (typeof reply !== 'boolean')
-        throw invalid('`delivery.reply` must be boolean');
-    if (reply && requesterNodeId === null)
-        throw invalid('`delivery.reply` requires `requester_node_id`');
-    return { placement: validatePlacement(raw['placement'], DEFAULT_DELIVERY.placement), inbox, reply };
-}
-function validateReplaceDelivery(raw, prior) {
-    if (raw === undefined)
-        return prior;
-    if (!isPlainObject(raw))
-        throw invalid('`delivery` must be an object');
-    requireNoExtraKeys(raw, ['placement'], '`delivery`');
-    return { ...prior, placement: validatePlacement(raw['placement'], prior.placement) };
-}
-function validateSource(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!isPlainObject(raw))
-        throw invalid('`source` must be an object');
-    requireNoExtraKeys(raw, SOURCE_FIELDS, '`source`');
-    const source = {};
-    for (const field of SOURCE_FIELDS) {
-        const value = raw[field];
-        if (value === undefined)
-            continue;
-        if (typeof value !== 'string' || value === '')
-            throw invalid(`\`source.${field}\` must be a nonempty string`);
-        source[field] = value;
-    }
-    return source;
-}
-function validateCreatorCwd(raw) {
-    if (typeof raw !== 'string' || raw === '')
-        throw invalid('`creator_cwd` is required');
-    if (!isAbsolute(raw))
-        throw invalid('`creator_cwd` must be an absolute path');
-    try {
-        if (!statSync(raw).isDirectory())
-            throw invalid(`\`creator_cwd\` is not a directory: ${raw}`);
-    }
-    catch (error) {
-        if (error instanceof ApiError)
-            throw error;
-        throw invalid(`\`creator_cwd\` does not exist: ${raw}`);
-    }
-    return raw;
-}
-function validateActionSelection(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (!isPlainObject(raw))
-        throw invalid('`action` must be an object');
-    requireNoExtraKeys(raw, ['name', 'payload'], '`action`');
-    if (typeof raw['name'] !== 'string' || !HUMAN_ACTION_NAME_PATTERN.test(raw['name']))
-        throw invalid('`action.name` must be a declared action name');
-    return { name: raw['name'], payload: raw['payload'] ?? null };
-}
-function validateRequesterNodeId(raw) {
-    if (raw === undefined || raw === null)
-        return null;
-    if (typeof raw !== 'string' || !isSafeNodeId(raw))
-        throw invalid('`requester_node_id` must be a safe node id or null');
-    return raw;
-}
-function validateCreateRequest(raw) {
-    if (!isPlainObject(raw))
-        throw invalid('request body is required');
-    requireNoExtraKeys(raw, ['page', 'delivery', 'source', 'requester_node_id', 'creator_cwd', 'action'], 'the request body');
-    const source = validateSource(raw['source']);
-    const requesterNodeId = validateRequesterNodeId(raw['requester_node_id']);
-    const action = validateActionSelection(raw['action']);
-    return {
-        page: validatePage(raw['page']),
-        delivery: validateCreateDelivery(raw['delivery'], requesterNodeId),
-        ...(source === undefined ? {} : { source }),
-        requesterNodeId,
-        creatorCwd: validateCreatorCwd(raw['creator_cwd']),
-        ...(action === undefined ? {} : { action }),
-    };
-}
-function validateReplaceRequest(raw, prior) {
-    if (!isPlainObject(raw))
-        throw invalid('request body is required');
-    requireNoExtraKeys(raw, ['page', 'delivery'], 'the request body');
-    return { page: validatePage(raw['page']), delivery: validateReplaceDelivery(raw['delivery'], prior) };
-}
-function optionalBoundedString(raw, field, max) {
-    if (raw === undefined)
-        return undefined;
-    if (typeof raw !== 'string' || raw.trim() === '' || raw.length > max)
-        throw invalid(`\`${field}\` must be nonempty after trim and at most ${max} characters`);
-    return raw;
-}
-function validateRespondRequest(raw) {
-    if (!isPlainObject(raw))
-        throw invalid('request body is required');
-    requireNoExtraKeys(raw, ['responses', 'actor'], 'the request body');
-    if (!isPlainObject(raw['responses']))
-        throw invalid('`responses` must be an object');
-    const actor = optionalBoundedString(raw['actor'], 'actor', ACTOR_MAX);
-    return { responses: raw['responses'], ...(actor === undefined ? {} : { actor }) };
-}
-function validateSettleRequest(raw) {
-    if (raw === undefined)
-        return {};
-    if (!isPlainObject(raw))
-        throw invalid('request body must be an object');
-    requireNoExtraKeys(raw, ['reason', 'actor'], 'the request body');
-    const reason = optionalBoundedString(raw['reason'], 'reason', REASON_MAX);
-    const actor = optionalBoundedString(raw['actor'], 'actor', ACTOR_MAX);
-    return { ...(reason === undefined ? {} : { reason }), ...(actor === undefined ? {} : { actor }) };
-}
-function requestId(ctx) {
-    const id = ctx.params['request_id'];
-    if (typeof id !== 'string' || id === '')
-        throw invalid('request id is required');
-    return id;
-}
-function requirePageRequest(id) {
-    const request = getRequest(id);
-    if (request === null || request.kind !== 'page')
-        throw new ApiError(404, 'not_found', 'no request with that id');
-    return request;
-}
-function manifest(request) {
-    try {
-        const value = JSON.parse(request.specification_json);
-        if (!isPlainObject(value))
-            throw new Error('not an object');
-        return value;
-    }
-    catch {
-        throw new ApiError(500, 'internal', 'the request specification could not be read');
-    }
-}
-function terminalResult(request) {
-    if (request.result_json === null)
-        return null;
-    try {
-        return JSON.parse(request.result_json);
-    }
-    catch {
-        throw new ApiError(500, 'internal', 'the request result could not be read');
-    }
-}
-function frozenAction(request) {
-    if (request.action_json === null)
-        return null;
-    try {
-        const action = JSON.parse(request.action_json);
-        if (action.schema !== 'crtr.human-action-binding/v1' || typeof action.name !== 'string')
-            throw new Error('invalid action');
-        return action;
-    }
-    catch {
-        throw new ApiError(500, 'internal', 'the request action could not be read');
-    }
-}
-function requestState(request) {
-    if (request.state !== 'settled')
-        return 'pending';
-    return request.outcome === 'answered' ? 'answered' : request.outcome === 'dismissed' ? 'dismissed' : 'canceled';
-}
-function deliveryDetail(request) {
-    if (request.action_delivery_id === null)
-        return { state: 'none', attempt: 0 };
-    const delivery = readExternalActionDelivery(`human-action:${request.inbox_ticket_id}`);
-    if (delivery === null)
-        return { state: 'none', attempt: 0 };
-    const state = delivery.state === 'acknowledged' ? 'accepted' : delivery.state === 'permanent_failed' ? 'permanent_failed' : delivery.state === 'handed_off' ? 'running' : 'pending';
-    const detail = { state, attempt: delivery.attempts };
-    if (state === 'pending' && delivery.nextAttemptAt !== null)
-        detail.next_attempt_at = new Date(delivery.nextAttemptAt).toISOString();
-    if (delivery.acknowledgedAt !== null)
-        detail.accepted_at = new Date(delivery.acknowledgedAt).toISOString();
-    if (delivery.failedAt !== null)
-        detail.permanent_failed_at = new Date(delivery.failedAt).toISOString();
-    if (delivery.lastFailure !== null)
-        detail.last_failure = delivery.lastFailure;
-    return detail;
-}
-function requestToDTO(request) {
-    const page = manifest(request);
-    const result = terminalResult(request);
-    const state = requestState(request);
-    const dto = {
-        request_id: request.request_id,
-        inbox_ticket_id: request.inbox_ticket_id,
-        request_dir: request.request_dir,
-        kind: request.kind,
-        state,
-        title: request.title,
-        source: page.source ?? {},
-        emitted_at: page.source?.emittedAt ?? request.created_at,
-    };
-    if (request.subtitle !== null)
-        dto.subtitle = request.subtitle;
-    if (request.kind === 'page')
-        dto.page = inboxPageProjection(request);
-    if (result !== null) {
-        dto.settled_at = request.settled_at ?? request.updated_at;
-        if (result.kind === 'page' && state === 'answered')
-            dto.responses = result.responses;
-        if (result.kind === 'canceled' && result.reason !== undefined)
-            dto.reason = result.reason;
-        if (result.kind === 'page' && result.actor !== undefined)
-            dto.actor = result.actor;
-        if (result.kind === 'canceled' && result.actor !== undefined)
-            dto.actor = result.actor;
-    }
-    const action = frozenAction(request);
-    if (action !== null) {
-        dto.action = { name: action.name, payload: action.payload };
-        dto.delivery = deliveryDetail(request);
-    }
-    return dto;
-}
-function prepareOrReject(dialect, document, source, delivery) {
-    try {
-        return preparePageSource({ dialect, document, source, delivery, productKinds: resolvePageComponents() });
-    }
-    catch (error) {
-        throw invalid(error instanceof Error ? error.message : 'the page could not be prepared');
-    }
-}
-function handleCreate(ctx) {
-    const request = validateCreateRequest(ctx.body);
-    let actionJson;
-    if (request.action !== undefined) {
-        const resolution = resolveHumanAction(request.action.name, request.creatorCwd);
-        if ('kind' in resolution) {
-            const detail = resolution.kind === 'unknown_action'
-                ? `no action named ${resolution.name} is declared from ${request.creatorCwd}`
-                : `${resolution.name} is declared in ${resolution.configOrigin} but unusable: ${resolution.reason}`;
-            throw new ApiError(400, resolution.kind, detail);
-        }
-        actionJson = JSON.stringify({
-            schema: 'crtr.human-action-binding/v1', name: request.action.name, payload: request.action.payload,
-            creatorCwd: request.creatorCwd, configOrigin: resolution.configOrigin, argv: resolution.argv, cwd: resolution.cwd,
-        });
-    }
-    const prepared = prepareOrReject(request.page.dialect, request.page.source, request.source, request.delivery);
-    const created = createPageRequest({
-        prepared,
-        requester_node_id: request.requesterNodeId,
-        ...(actionJson === undefined ? {} : { action_json: actionJson }),
-    });
-    return {
-        status: 201,
-        body: { request_id: created.request_id, request_dir: created.request_dir, state: 'pending', ...(request.action === undefined ? {} : { action: { name: request.action.name } }), delivery_state: 'none' },
-    };
-}
-function handleGet(ctx) {
-    return { status: 200, body: requestToDTO(requirePageRequest(requestId(ctx))) };
-}
-function handleReplace(ctx) {
-    const request = requirePageRequest(requestId(ctx));
-    if (request.state === 'settled')
-        throw new ApiError(409, 'already_settled', 'the request already has a terminal result');
-    const page = manifest(request);
-    const body = validateReplaceRequest(ctx.body, page.delivery);
-    const prepared = prepareOrReject(body.page.dialect, body.page.source, page.source, body.delivery);
-    try {
-        publishPage(request.request_dir, prepared);
-    }
-    catch (error) {
-        if (error instanceof Error && error.message === `page request is not open: ${request.request_id}`) {
-            throw new ApiError(409, 'already_settled', 'the request already has a terminal result');
-        }
-        throw error;
-    }
-    return { status: 200, body: requestToDTO(requirePageRequest(request.request_id)) };
-}
-function settlementError(error) {
-    if (error instanceof ApiError)
-        return error;
-    if (error instanceof Error && error.message.includes('unknown page request'))
-        return new ApiError(404, 'not_found', 'no request with that id');
-    if (error instanceof Error && error.message === 'page_has_no_response_lifecycle')
-        return new ApiError(409, 'not_settleable', 'this request carries no response lifecycle');
-    return new ApiError(500, 'internal', 'the request could not be settled');
-}
-function requireSettleable(request) {
-    if (request.state === 'settled')
-        throw new ApiError(409, 'already_settled', 'the request already has a terminal result');
-    if (!request.settleable)
-        throw new ApiError(409, 'not_settleable', 'this request carries no response lifecycle');
-}
-async function handleRespond(ctx) {
-    const request = requirePageRequest(requestId(ctx));
-    const body = validateRespondRequest(ctx.body);
-    requireSettleable(request);
-    try {
-        validatePageTicketResponses(request.request_dir, body.responses);
-    }
-    catch (error) {
-        throw invalid(error instanceof Error ? error.message : 'the response map is invalid');
-    }
-    try {
-        await resolvePageTicket(request.request_id, body.responses, body.actor === undefined ? {} : { actor: body.actor });
-    }
-    catch (error) {
-        throw settlementError(error);
-    }
-    return { status: 200, body: requestToDTO(requirePageRequest(request.request_id)) };
-}
-async function settle(ctx, disposition) {
-    const request = requirePageRequest(requestId(ctx));
-    const body = validateSettleRequest(ctx.body);
-    requireSettleable(request);
-    try {
-        await cancelHumanTicket(request.request_id, { ...body, disposition });
-    }
-    catch (error) {
-        throw settlementError(error);
-    }
-    return { status: 200, body: requestToDTO(requirePageRequest(request.request_id)) };
-}
-export const humanRequestRoutes = [
-    { method: 'POST', pattern: '/v1/human/requests', handler: handleCreate },
-    { method: 'GET', pattern: '/v1/human/requests/:request_id', handler: handleGet },
-    { method: 'POST', pattern: '/v1/human/requests/:request_id/replace', handler: handleReplace },
-    { method: 'POST', pattern: '/v1/human/requests/:request_id/respond', handler: handleRespond },
-    { method: 'POST', pattern: '/v1/human/requests/:request_id/dismiss', handler: (ctx) => settle(ctx, 'dismissed') },
-    { method: 'POST', pattern: '/v1/human/requests/:request_id/cancel', handler: (ctx) => settle(ctx, 'canceled') },
-];
+var O=Object.defineProperty;var o=(e,t)=>O(e,"name",{value:t,configurable:!0});import{statSync as R}from"node:fs";import{isAbsolute as j}from"node:path";import{ApiError as d}from"../../../api/index.js";import{readExternalActionDelivery as E}from"../../../core/canvas/deliveries.js";import{isSafeNodeId as P}from"../../../core/canvas/paths.js";import{resolvePageComponents as x}from"../../../core/config.js";import{resolveHumanAction as N}from"../../../core/human-actions.js";import{HUMAN_ACTION_NAME_PATTERN as T}from"../../../core/human/action-binding.js";import{createPageRequest as C,getRequest as $}from"../../../core/human/requests.js";import{preparePageSource as D}from"../../../core/human/page-authoring.js";import{publishPage as I,validatePageTicketResponses as J}from"../../../core/human/tickets.js";import{cancelHumanTicket as F,resolvePageTicket as M}from"../../human/finish.js";import{inboxPageProjection as H}from"./inbox-page.js";const L=1e3,y=200,f={placement:"inline",inbox:!0,reply:!1},_=["sessionName","askedBy","emittedAt","profileName","nodeId"];function c(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}o(c,"isPlainObject");function u(e,t,n){for(const r of Object.keys(e))if(!t.includes(r))throw new d(400,"invalid_request",`unexpected field in ${n}: ${r}`)}o(u,"requireNoExtraKeys");function i(e){return new d(400,"invalid_request",e)}o(i,"invalid");function b(e){if(!c(e))throw i("`page` must be an object");if(u(e,["dialect","source"],"`page`"),e.dialect!=="jsx"&&e.dialect!=="html")throw i('`page.dialect` must be "jsx" or "html"');if(typeof e.source!="string"||e.source.trim()==="")throw i("`page.source` must be the authored page text");return{dialect:e.dialect,source:e.source}}o(b,"validatePage");function g(e,t){const n=e??t;if(n!=="inline"&&n!=="panel")throw i('`delivery.placement` must be "inline" or "panel"');return n}o(g,"validatePlacement");function U(e,t){if(e===void 0)return f;if(!c(e))throw i("`delivery` must be an object");u(e,["placement","inbox","reply"],"`delivery`");const n=e.inbox??f.inbox,r=e.reply??f.reply;if(typeof n!="boolean")throw i("`delivery.inbox` must be boolean");if(typeof r!="boolean")throw i("`delivery.reply` must be boolean");if(r&&t===null)throw i("`delivery.reply` requires `requester_node_id`");return{placement:g(e.placement,f.placement),inbox:n,reply:r}}o(U,"validateCreateDelivery");function B(e,t){if(e===void 0)return t;if(!c(e))throw i("`delivery` must be an object");return u(e,["placement"],"`delivery`"),{...t,placement:g(e.placement,t.placement)}}o(B,"validateReplaceDelivery");function G(e){if(e===void 0)return;if(!c(e))throw i("`source` must be an object");u(e,_,"`source`");const t={};for(const n of _){const r=e[n];if(r!==void 0){if(typeof r!="string"||r==="")throw i(`\`source.${n}\` must be a nonempty string`);t[n]=r}}return t}o(G,"validateSource");function K(e){if(typeof e!="string"||e==="")throw i("`creator_cwd` is required");if(!j(e))throw i("`creator_cwd` must be an absolute path");try{if(!R(e).isDirectory())throw i(`\`creator_cwd\` is not a directory: ${e}`)}catch(t){throw t instanceof d?t:i(`\`creator_cwd\` does not exist: ${e}`)}return e}o(K,"validateCreatorCwd");function X(e){if(e!==void 0){if(!c(e))throw i("`action` must be an object");if(u(e,["name","payload"],"`action`"),typeof e.name!="string"||!T.test(e.name))throw i("`action.name` must be a declared action name");return{name:e.name,payload:e.payload??null}}}o(X,"validateActionSelection");function z(e){if(e==null)return null;if(typeof e!="string"||!P(e))throw i("`requester_node_id` must be a safe node id or null");return e}o(z,"validateRequesterNodeId");function V(e){if(!c(e))throw i("request body is required");u(e,["page","delivery","source","requester_node_id","creator_cwd","action"],"the request body");const t=G(e.source),n=z(e.requester_node_id),r=X(e.action);return{page:b(e.page),delivery:U(e.delivery,n),...t===void 0?{}:{source:t},requesterNodeId:n,creatorCwd:K(e.creator_cwd),...r===void 0?{}:{action:r}}}o(V,"validateCreateRequest");function Y(e,t){if(!c(e))throw i("request body is required");return u(e,["page","delivery"],"the request body"),{page:b(e.page),delivery:B(e.delivery,t)}}o(Y,"validateReplaceRequest");function h(e,t,n){if(e!==void 0){if(typeof e!="string"||e.trim()===""||e.length>n)throw i(`\`${t}\` must be nonempty after trim and at most ${n} characters`);return e}}o(h,"optionalBoundedString");function Q(e){if(!c(e))throw i("request body is required");if(u(e,["responses","actor"],"the request body"),!c(e.responses))throw i("`responses` must be an object");const t=h(e.actor,"actor",y);return{responses:e.responses,...t===void 0?{}:{actor:t}}}o(Q,"validateRespondRequest");function W(e){if(e===void 0)return{};if(!c(e))throw i("request body must be an object");u(e,["reason","actor"],"the request body");const t=h(e.reason,"reason",L),n=h(e.actor,"actor",y);return{...t===void 0?{}:{reason:t},...n===void 0?{}:{actor:n}}}o(W,"validateSettleRequest");function p(e){const t=e.params.request_id;if(typeof t!="string"||t==="")throw i("request id is required");return t}o(p,"requestId");function l(e){const t=$(e);if(t===null||t.kind!=="page")throw new d(404,"not_found","no request with that id");return t}o(l,"requirePageRequest");function q(e){try{const t=JSON.parse(e.specification_json);if(!c(t))throw new Error("not an object");return t}catch{throw new d(500,"internal","the request specification could not be read")}}o(q,"manifest");function Z(e){if(e.result_json===null)return null;try{return JSON.parse(e.result_json)}catch{throw new d(500,"internal","the request result could not be read")}}o(Z,"terminalResult");function ee(e){if(e.action_json===null)return null;try{const t=JSON.parse(e.action_json);if(t.schema!=="crtr.human-action-binding/v1"||typeof t.name!="string")throw new Error("invalid action");return t}catch{throw new d(500,"internal","the request action could not be read")}}o(ee,"frozenAction");function te(e){return e.state!=="settled"?"pending":e.outcome==="answered"?"answered":e.outcome==="dismissed"?"dismissed":"canceled"}o(te,"requestState");function ne(e){if(e.action_delivery_id===null)return{state:"none",attempt:0};const t=E(`human-action:${e.inbox_ticket_id}`);if(t===null)return{state:"none",attempt:0};const n=t.state==="acknowledged"?"accepted":t.state==="permanent_failed"?"permanent_failed":t.state==="handed_off"?"running":"pending",r={state:n,attempt:t.attempts};return n==="pending"&&t.nextAttemptAt!==null&&(r.next_attempt_at=new Date(t.nextAttemptAt).toISOString()),t.acknowledgedAt!==null&&(r.accepted_at=new Date(t.acknowledgedAt).toISOString()),t.failedAt!==null&&(r.permanent_failed_at=new Date(t.failedAt).toISOString()),t.lastFailure!==null&&(r.last_failure=t.lastFailure),r}o(ne,"deliveryDetail");function m(e){const t=q(e),n=Z(e),r=te(e),a={request_id:e.request_id,inbox_ticket_id:e.inbox_ticket_id,request_dir:e.request_dir,kind:e.kind,state:r,title:e.title,source:t.source??{},emitted_at:t.source?.emittedAt??e.created_at};e.subtitle!==null&&(a.subtitle=e.subtitle),e.kind==="page"&&(a.page=H(e)),n!==null&&(a.settled_at=e.settled_at??e.updated_at,n.kind==="page"&&r==="answered"&&(a.responses=n.responses),n.kind==="canceled"&&n.reason!==void 0&&(a.reason=n.reason),n.kind==="page"&&n.actor!==void 0&&(a.actor=n.actor),n.kind==="canceled"&&n.actor!==void 0&&(a.actor=n.actor));const s=ee(e);return s!==null&&(a.action={name:s.name,payload:s.payload},a.delivery=ne(e)),a}o(m,"requestToDTO");function v(e,t,n,r){try{return D({dialect:e,document:t,source:n,delivery:r,productKinds:x()})}catch(a){throw i(a instanceof Error?a.message:"the page could not be prepared")}}o(v,"prepareOrReject");function re(e){const t=V(e.body);let n;if(t.action!==void 0){const s=N(t.action.name,t.creatorCwd);if("kind"in s){const k=s.kind==="unknown_action"?`no action named ${s.name} is declared from ${t.creatorCwd}`:`${s.name} is declared in ${s.configOrigin} but unusable: ${s.reason}`;throw new d(400,s.kind,k)}n=JSON.stringify({schema:"crtr.human-action-binding/v1",name:t.action.name,payload:t.action.payload,creatorCwd:t.creatorCwd,configOrigin:s.configOrigin,argv:s.argv,cwd:s.cwd})}const r=v(t.page.dialect,t.page.source,t.source,t.delivery),a=C({prepared:r,requester_node_id:t.requesterNodeId,...n===void 0?{}:{action_json:n}});return{status:201,body:{request_id:a.request_id,request_dir:a.request_dir,state:"pending",...t.action===void 0?{}:{action:{name:t.action.name}},delivery_state:"none"}}}o(re,"handleCreate");function oe(e){return{status:200,body:m(l(p(e)))}}o(oe,"handleGet");function ie(e){const t=l(p(e));if(t.state==="settled")throw new d(409,"already_settled","the request already has a terminal result");const n=q(t),r=Y(e.body,n.delivery),a=v(r.page.dialect,r.page.source,n.source,r.delivery);try{I(t.request_dir,a)}catch(s){throw s instanceof Error&&s.message===`page request is not open: ${t.request_id}`?new d(409,"already_settled","the request already has a terminal result"):s}return{status:200,body:m(l(t.request_id))}}o(ie,"handleReplace");function w(e){return e instanceof d?e:e instanceof Error&&e.message.includes("unknown page request")?new d(404,"not_found","no request with that id"):e instanceof Error&&e.message==="page_has_no_response_lifecycle"?new d(409,"not_settleable","this request carries no response lifecycle"):new d(500,"internal","the request could not be settled")}o(w,"settlementError");function A(e){if(e.state==="settled")throw new d(409,"already_settled","the request already has a terminal result");if(!e.settleable)throw new d(409,"not_settleable","this request carries no response lifecycle")}o(A,"requireSettleable");async function ae(e){const t=l(p(e)),n=Q(e.body);A(t);try{J(t.request_dir,n.responses)}catch(r){throw i(r instanceof Error?r.message:"the response map is invalid")}try{await M(t.request_id,n.responses,n.actor===void 0?{}:{actor:n.actor})}catch(r){throw w(r)}return{status:200,body:m(l(t.request_id))}}o(ae,"handleRespond");async function S(e,t){const n=l(p(e)),r=W(e.body);A(n);try{await F(n.request_id,{...r,disposition:t})}catch(a){throw w(a)}return{status:200,body:m(l(n.request_id))}}o(S,"settle");const ve=[{method:"POST",pattern:"/v1/human/requests",handler:re},{method:"GET",pattern:"/v1/human/requests/:request_id",handler:oe},{method:"POST",pattern:"/v1/human/requests/:request_id/replace",handler:ie},{method:"POST",pattern:"/v1/human/requests/:request_id/respond",handler:ae},{method:"POST",pattern:"/v1/human/requests/:request_id/dismiss",handler:o(e=>S(e,"dismissed"),"handler")},{method:"POST",pattern:"/v1/human/requests/:request_id/cancel",handler:o(e=>S(e,"canceled"),"handler")}];export{ve as humanRequestRoutes};

package/dist/daemon/api/handlers/human.js

@@ -1,3 +1 @@
-// Human page and review lifecycle routes live on request identity. The former
-// bridge-creation and ticket resolve/cancel routes are intentionally absent.
-export const humanRoutes = [];
+const o=[];export{o as humanRoutes};

package/dist/daemon/api/handlers/inbox-page.js

@@ -1,89 +1 @@
-import { readFileSync } from 'node:fs';
-import { readPageFeedback } from '../../../core/human/feedback.js';
-import { pageModulePath, pagePath } from '../../../core/human/convention.js';
-import { parsePage } from '../../../core/human/page.js';
-import { presentationDir } from '../../../core/human/requests.js';
-import { readPageProgress, readTicketResult } from '../../../core/human/tickets.js';
-import { toPageFeedbackDTO } from '../map.js';
-function pageSlotToDTO(slot) {
-    const dto = {
-        kind: slot.kind,
-        step: slot.step,
-        config: slot.config,
-    };
-    if (slot.id !== undefined)
-        dto.id = slot.id;
-    if (slot.unvalidated === true)
-        dto.unvalidated = true;
-    if (slot.display === true)
-        dto.display = true;
-    return dto;
-}
-function pageManifestToDTO(manifest) {
-    const dto = {
-        schema: 'crtr.page/v2',
-        dialect: manifest.dialect,
-        title: manifest.title,
-        delivery: manifest.delivery,
-        document: manifest.document,
-        steps: manifest.steps,
-        slots: manifest.slots.map(pageSlotToDTO),
-    };
-    if (manifest.subtitle !== undefined)
-        dto.subtitle = manifest.subtitle;
-    if (manifest.source !== undefined) {
-        const source = {};
-        if (manifest.source.sessionName !== undefined)
-            source.sessionName = manifest.source.sessionName;
-        if (manifest.source.askedBy !== undefined)
-            source.askedBy = manifest.source.askedBy;
-        if (manifest.source.emittedAt !== undefined)
-            source.emittedAt = manifest.source.emittedAt;
-        if (manifest.source.profileName !== undefined)
-            source.profileName = manifest.source.profileName;
-        if (manifest.source.nodeId !== undefined)
-            source.nodeId = manifest.source.nodeId;
-        if (Object.keys(source).length > 0)
-            dto.source = source;
-    }
-    return dto;
-}
-function state(request) {
-    if (!request.settleable)
-        return 'passive';
-    if (request.state !== 'settled')
-        return 'pending';
-    return request.outcome === 'canceled' || request.outcome === 'dismissed' ? 'canceled' : 'resolved';
-}
-function result(request) {
-    const terminal = readTicketResult(request.request_dir);
-    if (terminal === null)
-        return null;
-    if (terminal.kind === 'page' || terminal.kind === 'canceled') {
-        return terminal;
-    }
-    throw new Error(`page request has an invalid terminal result: ${request.request_id}`);
-}
-/** Project the one SQL-selected page revision for every page reader. */
-export function inboxPageProjection(request) {
-    if (request.kind !== 'page')
-        throw new Error(`request is not a page: ${request.request_id}`);
-    const revision = presentationDir(request);
-    const manifest = parsePage(revision);
-    const sourceDocument = readFileSync(pagePath(revision, manifest.dialect), 'utf8');
-    const document = manifest.dialect === 'jsx' ? readFileSync(pageModulePath(revision), 'utf8') : sourceDocument;
-    const progress = request.settleable ? readPageProgress(request.request_dir) : null;
-    return {
-        ticket_id: request.inbox_ticket_id,
-        kind: 'page',
-        state: state(request),
-        revision,
-        page: pageManifestToDTO(manifest),
-        document,
-        source_document: sourceDocument,
-        document_media_type: manifest.dialect === 'jsx' ? 'text/jsx' : 'text/html',
-        progress: progress === null ? null : { responses: progress },
-        result: result(request),
-        feedback: toPageFeedbackDTO(readPageFeedback(request.request_dir)),
-    };
-}
+var u=Object.defineProperty;var i=(e,t)=>u(e,"name",{value:t,configurable:!0});import{readFileSync as n}from"node:fs";import{readPageFeedback as s}from"../../../core/human/feedback.js";import{pageModulePath as a,pagePath as l}from"../../../core/human/convention.js";import{parsePage as p}from"../../../core/human/page.js";import{presentationDir as f}from"../../../core/human/requests.js";import{readPageProgress as g,readTicketResult as m}from"../../../core/human/tickets.js";import{toPageFeedbackDTO as k}from"../map.js";function b(e){const t={kind:e.kind,step:e.step,config:e.config};return e.id!==void 0&&(t.id=e.id),e.unvalidated===!0&&(t.unvalidated=!0),e.display===!0&&(t.display=!0),t}i(b,"pageSlotToDTO");function _(e){const t={schema:"crtr.page/v2",dialect:e.dialect,title:e.title,delivery:e.delivery,document:e.document,steps:e.steps,slots:e.slots.map(b)};if(e.subtitle!==void 0&&(t.subtitle=e.subtitle),e.source!==void 0){const r={};e.source.sessionName!==void 0&&(r.sessionName=e.source.sessionName),e.source.askedBy!==void 0&&(r.askedBy=e.source.askedBy),e.source.emittedAt!==void 0&&(r.emittedAt=e.source.emittedAt),e.source.profileName!==void 0&&(r.profileName=e.source.profileName),e.source.nodeId!==void 0&&(r.nodeId=e.source.nodeId),Object.keys(r).length>0&&(t.source=r)}return t}i(_,"pageManifestToDTO");function y(e){return e.settleable?e.state!=="settled"?"pending":e.outcome==="canceled"||e.outcome==="dismissed"?"canceled":"resolved":"passive"}i(y,"state");function v(e){const t=m(e.request_dir);if(t===null)return null;if(t.kind==="page"||t.kind==="canceled")return t;throw new Error(`page request has an invalid terminal result: ${e.request_id}`)}i(v,"result");function O(e){if(e.kind!=="page")throw new Error(`request is not a page: ${e.request_id}`);const t=f(e),r=p(t),o=n(l(t,r.dialect),"utf8"),c=r.dialect==="jsx"?n(a(t),"utf8"):o,d=e.settleable?g(e.request_dir):null;return{ticket_id:e.inbox_ticket_id,kind:"page",state:y(e),revision:t,page:_(r),document:c,source_document:o,document_media_type:r.dialect==="jsx"?"text/jsx":"text/html",progress:d===null?null:{responses:d},result:v(e),feedback:k(s(e.request_dir))}}i(O,"inboxPageProjection");export{O as inboxPageProjection};