@xemahq/platform-common 0.1.3

package/dist/lib/agent-session.types.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionReadAction = exports.SessionMutatingAction = exports.PROVISIONING_PHASE_LABELS = exports.PROVISIONING_PHASE_ORDER = exports.SessionProvisioningPhase = exports.SessionStreamEventType = exports.AGENT_SESSION_EVENT_FAMILY = exports.SessionEventType = void 0;
+var SessionEventType;
+(function (SessionEventType) {
+    SessionEventType["MessageSent"] = "message_sent";
+    SessionEventType["MessageReceived"] = "message_received";
+    SessionEventType["ToolCallStarted"] = "tool_call_started";
+    SessionEventType["ToolCallCompleted"] = "tool_call_completed";
+    SessionEventType["FileCreated"] = "file_created";
+    SessionEventType["FileEdited"] = "file_edited";
+    SessionEventType["FileDeleted"] = "file_deleted";
+    SessionEventType["GitBranchCreated"] = "git_branch_created";
+    SessionEventType["GitCommitted"] = "git_committed";
+    SessionEventType["GitPushed"] = "git_pushed";
+    SessionEventType["PrCreated"] = "pr_created";
+    SessionEventType["KbPagePushed"] = "kb_page_pushed";
+    SessionEventType["StatusChanged"] = "status_changed";
+    SessionEventType["AttachmentAdded"] = "attachment_added";
+    SessionEventType["AttachmentRemoved"] = "attachment_removed";
+    SessionEventType["SessionPaused"] = "session_paused";
+    SessionEventType["SessionResumed"] = "session_resumed";
+    SessionEventType["BudgetWarning"] = "budget_warning";
+    SessionEventType["IdleWarning"] = "idle_warning";
+    SessionEventType["UnknownOpencodeEvent"] = "unknown_opencode_event";
+    SessionEventType["QuestionAsked"] = "question_asked";
+    SessionEventType["QuestionAnswered"] = "question_answered";
+    SessionEventType["QuestionRejected"] = "question_rejected";
+    SessionEventType["McpAttached"] = "mcp_attached";
+    SessionEventType["McpDetached"] = "mcp_detached";
+    SessionEventType["SkillAttached"] = "skill_attached";
+    SessionEventType["SkillDetached"] = "skill_detached";
+    SessionEventType["SubagentAttached"] = "subagent_attached";
+    SessionEventType["SubagentDetached"] = "subagent_detached";
+    SessionEventType["SubagentModelChanged"] = "subagent_model_changed";
+    SessionEventType["AgentChanged"] = "agent_changed";
+    SessionEventType["SessionDegraded"] = "session_degraded";
+    SessionEventType["TodoUpdated"] = "todo_updated";
+    SessionEventType["SessionCompacted"] = "session_compacted";
+    SessionEventType["PermissionAsked"] = "permission_asked";
+    SessionEventType["PermissionReplied"] = "permission_replied";
+    SessionEventType["McpToolsChanged"] = "mcp_tools_changed";
+    SessionEventType["FileWatcherUpdated"] = "file_watcher_updated";
+    SessionEventType["LspDiagnostics"] = "lsp_diagnostics";
+    SessionEventType["Error"] = "error";
+    SessionEventType["OutputSurfaceDetected"] = "output_surface_detected";
+    SessionEventType["OutputSurfaceDeclarationNeeded"] = "output_surface_declaration_needed";
+    SessionEventType["OutputSurfaceDeclarationInvalid"] = "output_surface_declaration_invalid";
+    SessionEventType["OutputSurfaceInstalling"] = "output_surface_installing";
+    SessionEventType["OutputSurfaceInstallFailed"] = "output_surface_install_failed";
+    SessionEventType["OutputSurfaceStarting"] = "output_surface_starting";
+    SessionEventType["OutputSurfaceReady"] = "output_surface_ready";
+    SessionEventType["OutputSurfaceExited"] = "output_surface_exited";
+    SessionEventType["OutputSurfaceRestarted"] = "output_surface_restarted";
+    SessionEventType["ProvisioningPhaseChanged"] = "provisioning_phase_changed";
+    SessionEventType["StepFinished"] = "step_finished";
+    SessionEventType["TextDelta"] = "text_delta";
+    SessionEventType["ReasoningDelta"] = "reasoning_delta";
+    SessionEventType["ToolResult"] = "tool_result";
+    SessionEventType["EnvironmentDriftDetected"] = "environment_drift_detected";
+    SessionEventType["KbMountsApplied"] = "kb_mounts_applied";
+    SessionEventType["TurnReaped"] = "turn_reaped";
+    SessionEventType["OrgDbResult"] = "org_db_result";
+})(SessionEventType || (exports.SessionEventType = SessionEventType = {}));
+exports.AGENT_SESSION_EVENT_FAMILY = 'AGENT_SESSION';
+var SessionStreamEventType;
+(function (SessionStreamEventType) {
+    SessionStreamEventType["Delta"] = "delta";
+    SessionStreamEventType["Reasoning"] = "reasoning";
+    SessionStreamEventType["ToolCall"] = "tool_call";
+    SessionStreamEventType["TodoUpdated"] = "todo_updated";
+    SessionStreamEventType["FileChange"] = "file_change";
+    SessionStreamEventType["StatusChange"] = "status_change";
+    SessionStreamEventType["Activity"] = "activity";
+    SessionStreamEventType["Heartbeat"] = "heartbeat";
+    SessionStreamEventType["Done"] = "done";
+    SessionStreamEventType["QuestionAsked"] = "question_asked";
+    SessionStreamEventType["QuestionReplied"] = "question_replied";
+    SessionStreamEventType["QuestionRejected"] = "question_rejected";
+    SessionStreamEventType["PermissionAsked"] = "permission_asked";
+    SessionStreamEventType["PermissionReplied"] = "permission_replied";
+    SessionStreamEventType["SessionCompacted"] = "session_compacted";
+    SessionStreamEventType["McpToolsChanged"] = "mcp_tools_changed";
+    SessionStreamEventType["FileWatcherUpdated"] = "file_watcher_updated";
+    SessionStreamEventType["LspDiagnostics"] = "lsp_diagnostics";
+    SessionStreamEventType["LspUpdated"] = "lsp_updated";
+    SessionStreamEventType["ProvisioningPhaseChanged"] = "provisioning_phase_changed";
+    SessionStreamEventType["StepFinished"] = "step_finished";
+    SessionStreamEventType["Queued"] = "queued";
+    SessionStreamEventType["Error"] = "error";
+})(SessionStreamEventType || (exports.SessionStreamEventType = SessionStreamEventType = {}));
+var SessionProvisioningPhase;
+(function (SessionProvisioningPhase) {
+    SessionProvisioningPhase["Queued"] = "queued";
+    SessionProvisioningPhase["WorkerLaunching"] = "worker_launching";
+    SessionProvisioningPhase["WorkerWaitingReady"] = "worker_waiting_ready";
+    SessionProvisioningPhase["CredentialsInjecting"] = "credentials_injecting";
+    SessionProvisioningPhase["WorkspacePreparing"] = "workspace_preparing";
+    SessionProvisioningPhase["ConfigWriting"] = "config_writing";
+    SessionProvisioningPhase["ConfigReloading"] = "config_reloading";
+    SessionProvisioningPhase["ModelVerifying"] = "model_verifying";
+    SessionProvisioningPhase["ToolsVerifying"] = "tools_verifying";
+    SessionProvisioningPhase["Ready"] = "ready";
+    SessionProvisioningPhase["Failed"] = "failed";
+})(SessionProvisioningPhase || (exports.SessionProvisioningPhase = SessionProvisioningPhase = {}));
+exports.PROVISIONING_PHASE_ORDER = [
+    SessionProvisioningPhase.Queued,
+    SessionProvisioningPhase.WorkerLaunching,
+    SessionProvisioningPhase.WorkerWaitingReady,
+    SessionProvisioningPhase.CredentialsInjecting,
+    SessionProvisioningPhase.ConfigWriting,
+    SessionProvisioningPhase.ConfigReloading,
+    SessionProvisioningPhase.WorkspacePreparing,
+    SessionProvisioningPhase.ModelVerifying,
+    SessionProvisioningPhase.ToolsVerifying,
+    SessionProvisioningPhase.Ready,
+];
+exports.PROVISIONING_PHASE_LABELS = {
+    [SessionProvisioningPhase.Queued]: 'Queued in worker pool',
+    [SessionProvisioningPhase.WorkerLaunching]: 'Launching worker container',
+    [SessionProvisioningPhase.WorkerWaitingReady]: 'Waiting for worker boot',
+    [SessionProvisioningPhase.CredentialsInjecting]: 'Injecting credentials',
+    [SessionProvisioningPhase.WorkspacePreparing]: 'Preparing workspace',
+    [SessionProvisioningPhase.ConfigWriting]: 'Writing workspace config',
+    [SessionProvisioningPhase.ConfigReloading]: 'Reloading worker config',
+    [SessionProvisioningPhase.ModelVerifying]: 'Verifying model',
+    [SessionProvisioningPhase.ToolsVerifying]: 'Verifying tools',
+    [SessionProvisioningPhase.Ready]: 'Ready',
+    [SessionProvisioningPhase.Failed]: 'Failed',
+};
+var SessionMutatingAction;
+(function (SessionMutatingAction) {
+    SessionMutatingAction["SendMessage"] = "send_message";
+    SessionMutatingAction["Interrupt"] = "interrupt";
+    SessionMutatingAction["Pause"] = "pause";
+    SessionMutatingAction["Resume"] = "resume";
+    SessionMutatingAction["Terminate"] = "terminate";
+    SessionMutatingAction["Promote"] = "promote";
+    SessionMutatingAction["GitCommit"] = "git_commit";
+    SessionMutatingAction["GitPush"] = "git_push";
+    SessionMutatingAction["GitBranch"] = "git_branch";
+    SessionMutatingAction["KbPush"] = "kb_push";
+    SessionMutatingAction["AddAttachment"] = "add_attachment";
+    SessionMutatingAction["RemoveAttachment"] = "remove_attachment";
+})(SessionMutatingAction || (exports.SessionMutatingAction = SessionMutatingAction = {}));
+var SessionReadAction;
+(function (SessionReadAction) {
+    SessionReadAction["GetSession"] = "get_session";
+    SessionReadAction["ListMessages"] = "list_messages";
+    SessionReadAction["StreamEvents"] = "stream_events";
+    SessionReadAction["BrowseFiles"] = "browse_files";
+    SessionReadAction["GetGitStatus"] = "get_git_status";
+    SessionReadAction["GetGitDiff"] = "get_git_diff";
+    SessionReadAction["GetUsage"] = "get_usage";
+})(SessionReadAction || (exports.SessionReadAction = SessionReadAction = {}));
+//# sourceMappingURL=agent-session.types.js.map

package/dist/lib/agent-session.types.js.map

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

package/dist/lib/approval-mode.d.ts

@@ -0,0 +1,9 @@
+export declare const PIPELINE_APPROVAL_MODES: readonly ["AUTO", "HUMAN_REQUIRED"];
+export type PipelineApprovalMode = (typeof PIPELINE_APPROVAL_MODES)[number];
+export declare const PIPELINE_APPROVAL_MODE_SET: ReadonlySet<string>;
+export declare function parsePipelineApprovalMode(value: string | null | undefined): PipelineApprovalMode | undefined;
+export declare const GOVERNANCE_APPROVAL_MODES: readonly ["AUTO", "SUPERVISED", "HUMAN_REQUIRED", "REVIEW_FIRST"];
+export type GovernanceApprovalMode = (typeof GOVERNANCE_APPROVAL_MODES)[number];
+export declare const GOVERNANCE_APPROVAL_MODE_SET: ReadonlySet<string>;
+export declare function parseGovernanceApprovalMode(value: string | null | undefined): GovernanceApprovalMode | undefined;
+//# sourceMappingURL=approval-mode.d.ts.map

package/dist/lib/approval-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-mode.d.ts","sourceRoot":"","sources":["../../src/lib/approval-mode.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,uBAAuB,qCAAsC,CAAC;AAG3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG5E,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,CAE1D,CAAC;AAMF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,oBAAoB,GAAG,SAAS,CAKlC;AAKD,eAAO,MAAM,yBAAyB,mEAK5B,CAAC;AAGX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGhF,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAE5D,CAAC;AAMF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,sBAAsB,GAAG,SAAS,CAKpC"}

package/dist/lib/approval-mode.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOVERNANCE_APPROVAL_MODE_SET = exports.GOVERNANCE_APPROVAL_MODES = exports.PIPELINE_APPROVAL_MODE_SET = exports.PIPELINE_APPROVAL_MODES = void 0;
+exports.parsePipelineApprovalMode = parsePipelineApprovalMode;
+exports.parseGovernanceApprovalMode = parseGovernanceApprovalMode;
+exports.PIPELINE_APPROVAL_MODES = ['AUTO', 'HUMAN_REQUIRED'];
+exports.PIPELINE_APPROVAL_MODE_SET = new Set(exports.PIPELINE_APPROVAL_MODES);
+function parsePipelineApprovalMode(value) {
+    if (value && exports.PIPELINE_APPROVAL_MODE_SET.has(value)) {
+        return value;
+    }
+    return undefined;
+}
+exports.GOVERNANCE_APPROVAL_MODES = [
+    'AUTO',
+    'SUPERVISED',
+    'HUMAN_REQUIRED',
+    'REVIEW_FIRST',
+];
+exports.GOVERNANCE_APPROVAL_MODE_SET = new Set(exports.GOVERNANCE_APPROVAL_MODES);
+function parseGovernanceApprovalMode(value) {
+    if (value && exports.GOVERNANCE_APPROVAL_MODE_SET.has(value)) {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=approval-mode.js.map

package/dist/lib/approval-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-mode.js","sourceRoot":"","sources":["../../src/lib/approval-mode.ts"],"names":[],"mappings":";;;AA8BA,8DAOC;AAwBD,kEAOC;AApDY,QAAA,uBAAuB,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAU,CAAC;AAM9D,QAAA,0BAA0B,GAAwB,IAAI,GAAG,CACpE,+BAAuB,CACxB,CAAC;AAMF,SAAgB,yBAAyB,CACvC,KAAgC;IAEhC,IAAI,KAAK,IAAI,kCAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,KAA6B,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAKY,QAAA,yBAAyB,GAAG;IACvC,MAAM;IACN,YAAY;IACZ,gBAAgB;IAChB,cAAc;CACN,CAAC;AAME,QAAA,4BAA4B,GAAwB,IAAI,GAAG,CACtE,iCAAyB,CAC1B,CAAC;AAMF,SAAgB,2BAA2B,CACzC,KAAgC;IAEhC,IAAI,KAAK,IAAI,oCAA4B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,KAA+B,CAAC;IACzC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/lib/briefcase/index.d.ts

@@ -0,0 +1,18 @@
+import type { Briefcase, BriefcaseMcpTool, BriefcaseReference, BriefcaseReferenceKind, BriefcaseUpload } from '@xemahq/workflow-contracts';
+export declare function resolveBriefcase(briefcase: Briefcase | undefined): Briefcase;
+export declare function getVar(briefcase: Briefcase | undefined, key: string, fallback?: string): string | undefined;
+export declare function requireVar(briefcase: Briefcase | undefined, key: string): string;
+export declare class BriefcaseVarMissingError extends Error {
+    readonly key: string;
+    constructor(message: string, key: string);
+}
+export declare function getUploads(briefcase: Briefcase | undefined, filter?: {
+    readonly contentTypePrefix?: string;
+}): readonly BriefcaseUpload[];
+export declare function getReferences(briefcase: Briefcase | undefined, filter?: {
+    readonly kinds?: readonly BriefcaseReferenceKind[];
+}): readonly BriefcaseReference[];
+export declare function getMcpTools(briefcase: Briefcase | undefined): readonly BriefcaseMcpTool[];
+export declare function isEmpty(briefcase: Briefcase | undefined): boolean;
+export declare function briefcaseSummary(briefcase: Briefcase | undefined): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/briefcase/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/briefcase/index.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EAChB,MAAM,4BAA4B,CAAC;AASpC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAE5E;AAGD,wBAAgB,MAAM,CACpB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAIpB;AAGD,wBAAgB,UAAU,CACxB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,SAAgB,GAAG,EAAE,MAAM,CAAC;gBAChB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKzC;AAOD,wBAAgB,UAAU,CACxB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,SAAS,eAAe,EAAE,CAO5B;AAOD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAAE,GAC9D,SAAS,kBAAkB,EAAE,CAK/B;AASD,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,GAAG,SAAS,GAC/B,SAAS,gBAAgB,EAAE,CAE7B;AAQD,wBAAgB,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAQjE;AAQD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CASzE"}

package/dist/lib/briefcase/index.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BriefcaseVarMissingError = void 0;
+exports.resolveBriefcase = resolveBriefcase;
+exports.getVar = getVar;
+exports.requireVar = requireVar;
+exports.getUploads = getUploads;
+exports.getReferences = getReferences;
+exports.getMcpTools = getMcpTools;
+exports.isEmpty = isEmpty;
+exports.briefcaseSummary = briefcaseSummary;
+const workflow_contracts_1 = require("@xemahq/workflow-contracts");
+function resolveBriefcase(briefcase) {
+    return briefcase ?? (0, workflow_contracts_1.emptyBriefcase)();
+}
+function getVar(briefcase, key, fallback) {
+    const value = briefcase?.vars?.[key];
+    if (typeof value === 'string')
+        return value;
+    return fallback;
+}
+function requireVar(briefcase, key) {
+    const value = getVar(briefcase, key);
+    if (value === undefined) {
+        throw new BriefcaseVarMissingError(`Briefcase var '${key}' is required but not set. Available keys: [${Object.keys(briefcase?.vars ?? {}).join(', ')}]`, key);
+    }
+    return value;
+}
+class BriefcaseVarMissingError extends Error {
+    key;
+    constructor(message, key) {
+        super(message);
+        this.name = 'BriefcaseVarMissingError';
+        this.key = key;
+    }
+}
+exports.BriefcaseVarMissingError = BriefcaseVarMissingError;
+function getUploads(briefcase, filter) {
+    const all = briefcase?.uploads ?? [];
+    if (!filter?.contentTypePrefix)
+        return all;
+    const prefix = filter.contentTypePrefix;
+    return all.filter((u) => u.contentType !== null && u.contentType.startsWith(prefix));
+}
+function getReferences(briefcase, filter) {
+    const all = briefcase?.references ?? [];
+    if (!filter?.kinds || filter.kinds.length === 0)
+        return all;
+    const kindSet = new Set(filter.kinds);
+    return all.filter((r) => kindSet.has(r.kind));
+}
+function getMcpTools(briefcase) {
+    return briefcase?.mcpTools ?? [];
+}
+function isEmpty(briefcase) {
+    if (!briefcase)
+        return true;
+    return (Object.keys(briefcase.vars).length === 0 &&
+        briefcase.uploads.length === 0 &&
+        briefcase.references.length === 0 &&
+        briefcase.mcpTools.length === 0);
+}
+function briefcaseSummary(briefcase) {
+    if (isEmpty(briefcase))
+        return 'briefcase=empty';
+    const bc = briefcase;
+    return (`briefcase=uploads:${bc.uploads.length} ` +
+        `refs:${bc.references.length} ` +
+        `vars:[${Object.keys(bc.vars).join(',')}] ` +
+        `mcpTools:${bc.mcpTools.length}`);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/briefcase/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/briefcase/index.ts"],"names":[],"mappings":";;;AAoCA,4CAEC;AAGD,wBAQC;AAGD,gCAYC;AAgBD,gCAUC;AAOD,sCAQC;AASD,kCAIC;AAQD,0BAQC;AAQD,4CASC;AA3HD,mEAA4D;AAQ5D,SAAgB,gBAAgB,CAAC,SAAgC;IAC/D,OAAO,SAAS,IAAI,IAAA,mCAAc,GAAE,CAAC;AACvC,CAAC;AAGD,SAAgB,MAAM,CACpB,SAAgC,EAChC,GAAW,EACX,QAAiB;IAEjB,MAAM,KAAK,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAGD,SAAgB,UAAU,CACxB,SAAgC,EAChC,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,GAAG,+CAA+C,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACpH,GAAG,CACJ,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAa,wBAAyB,SAAQ,KAAK;IACjC,GAAG,CAAS;IAC5B,YAAY,OAAe,EAAE,GAAW;QACtC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAPD,4DAOC;AAOD,SAAgB,UAAU,CACxB,SAAgC,EAChC,MAAgD;IAEhD,MAAM,GAAG,GAAG,SAAS,EAAE,OAAO,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,iBAAiB;QAAE,OAAO,GAAG,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACxC,OAAO,GAAG,CAAC,MAAM,CACf,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAClE,CAAC;AACJ,CAAC;AAOD,SAAgB,aAAa,CAC3B,SAAgC,EAChC,MAA+D;IAE/D,MAAM,GAAG,GAAG,SAAS,EAAE,UAAU,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAyB,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAChD,CAAC;AASD,SAAgB,WAAW,CACzB,SAAgC;IAEhC,OAAO,SAAS,EAAE,QAAQ,IAAI,EAAE,CAAC;AACnC,CAAC;AAQD,SAAgB,OAAO,CAAC,SAAgC;IACtD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QACxC,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC9B,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAChC,CAAC;AACJ,CAAC;AAQD,SAAgB,gBAAgB,CAAC,SAAgC;IAC/D,IAAI,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACjD,MAAM,EAAE,GAAG,SAAU,CAAC;IACtB,OAAO,CACL,qBAAqB,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG;QACzC,QAAQ,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG;QAC/B,SAAS,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI;QAC3C,YAAY,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CACjC,CAAC;AACJ,CAAC"}

package/dist/lib/deliverable-output-contract.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+export declare const DeliverableContentKind: {
+    readonly Json: "json";
+    readonly Markdown: "markdown";
+    readonly Text: "text";
+};
+export type DeliverableContentKindValue = (typeof DeliverableContentKind)[keyof typeof DeliverableContentKind];
+declare const FileEntrySchema: z.ZodObject<{
+    canonicalPath: z.ZodString;
+    required: z.ZodBoolean;
+    purpose: z.ZodString;
+    contentKind: z.ZodEnum<{
+        json: "json";
+        markdown: "markdown";
+        text: "text";
+    }>;
+    schemaRef: z.ZodOptional<z.ZodString>;
+    fallbackPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const MultiPageSchema: z.ZodObject<{
+    manifestPath: z.ZodString;
+    pagePathTemplate: z.ZodString;
+    pages: z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const DeliverableOutputContractMode: {
+    readonly WorkspaceFiles: "workspace-files";
+    readonly ResponseOnly: "response-only";
+    readonly EndpointFetch: "endpoint-fetch";
+    readonly NoOutput: "no-output";
+};
+export type DeliverableOutputContractModeValue = (typeof DeliverableOutputContractMode)[keyof typeof DeliverableOutputContractMode];
+export declare const DeliverableTargetSlotKind: {
+    readonly Deliverables: "deliverables";
+    readonly Repos: "repos";
+};
+export type DeliverableTargetSlotKindValue = (typeof DeliverableTargetSlotKind)[keyof typeof DeliverableTargetSlotKind];
+declare const TargetSlotDescriptorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"deliverables">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"repos">;
+    repoSlug: z.ZodString;
+}, z.core.$strict>], "kind">;
+export declare const DeliverableOutputContractSchema: z.ZodObject<{
+    title: z.ZodString;
+    mode: z.ZodEnum<{
+        "workspace-files": "workspace-files";
+        "response-only": "response-only";
+        "endpoint-fetch": "endpoint-fetch";
+        "no-output": "no-output";
+    }>;
+    targetSlot: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"deliverables">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"repos">;
+        repoSlug: z.ZodString;
+    }, z.core.$strict>], "kind">>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        canonicalPath: z.ZodString;
+        required: z.ZodBoolean;
+        purpose: z.ZodString;
+        contentKind: z.ZodEnum<{
+            json: "json";
+            markdown: "markdown";
+            text: "text";
+        }>;
+        schemaRef: z.ZodOptional<z.ZodString>;
+        fallbackPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+    multiPage: z.ZodOptional<z.ZodObject<{
+        manifestPath: z.ZodString;
+        pagePathTemplate: z.ZodString;
+        pages: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            title: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DeliverableOutputContract = z.infer<typeof DeliverableOutputContractSchema>;
+export type DeliverableOutputContractFile = z.infer<typeof FileEntrySchema>;
+export type DeliverableOutputContractMultiPage = z.infer<typeof MultiPageSchema>;
+export type DeliverableTargetSlotDescriptor = z.infer<typeof TargetSlotDescriptorSchema>;
+export {};
+//# sourceMappingURL=deliverable-output-contract.d.ts.map

package/dist/lib/deliverable-output-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliverable-output-contract.d.ts","sourceRoot":"","sources":["../../src/lib/deliverable-output-contract.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAEvE,QAAA,MAAM,eAAe;;;;;;;;;;;kBAgBV,CAAC;AAEZ,QAAA,MAAM,eAAe;;;;;;;kBAkBV,CAAC;AAEZ,eAAO,MAAM,6BAA6B;;;;;CAKhC,CAAC;AAEX,MAAM,MAAM,kCAAkC,GAC5C,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,OAAO,6BAA6B,CAAC,CAAC;AAcrF,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX,MAAM,MAAM,8BAA8B,GACxC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAI7E,QAAA,MAAM,0BAA0B;;;;;4BAkB9B,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgDxC,CAAC;AAEL,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC5E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACjF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/lib/deliverable-output-contract.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliverableOutputContractSchema = exports.DeliverableTargetSlotKind = exports.DeliverableOutputContractMode = exports.DeliverableContentKind = void 0;
+const zod_1 = require("zod");
+const SAFE_PATH_PATTERN = /^[a-zA-Z0-9._\-/]+$/;
+exports.DeliverableContentKind = {
+    Json: 'json',
+    Markdown: 'markdown',
+    Text: 'text',
+};
+const FileEntrySchema = zod_1.z
+    .object({
+    canonicalPath: zod_1.z
+        .string()
+        .min(1)
+        .regex(SAFE_PATH_PATTERN, 'canonicalPath must use [a-zA-Z0-9._-/] only'),
+    required: zod_1.z.boolean(),
+    purpose: zod_1.z.string().min(1),
+    contentKind: zod_1.z.enum([
+        exports.DeliverableContentKind.Json,
+        exports.DeliverableContentKind.Markdown,
+        exports.DeliverableContentKind.Text,
+    ]),
+    schemaRef: zod_1.z.string().min(1).optional(),
+    fallbackPaths: zod_1.z.array(zod_1.z.string().min(1).regex(SAFE_PATH_PATTERN)).optional(),
+})
+    .strict();
+const MultiPageSchema = zod_1.z
+    .object({
+    manifestPath: zod_1.z.string().min(1).regex(SAFE_PATH_PATTERN),
+    pagePathTemplate: zod_1.z
+        .string()
+        .min(1)
+        .regex(/^[a-zA-Z0-9._\-/]+<slug>[a-zA-Z0-9._\-/]*$/, 'pagePathTemplate must contain a literal `<slug>` placeholder'),
+    pages: zod_1.z
+        .array(zod_1.z
+        .object({
+        slug: zod_1.z.string().min(1),
+        title: zod_1.z.string().min(1),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+exports.DeliverableOutputContractMode = {
+    WorkspaceFiles: 'workspace-files',
+    ResponseOnly: 'response-only',
+    EndpointFetch: 'endpoint-fetch',
+    NoOutput: 'no-output',
+};
+exports.DeliverableTargetSlotKind = {
+    Deliverables: 'deliverables',
+    Repos: 'repos',
+};
+const REPO_SLUG_PATTERN = /^[a-z0-9][a-z0-9-_]*$/;
+const TargetSlotDescriptorSchema = zod_1.z.discriminatedUnion('kind', [
+    zod_1.z
+        .object({
+        kind: zod_1.z.literal(exports.DeliverableTargetSlotKind.Deliverables),
+    })
+        .strict(),
+    zod_1.z
+        .object({
+        kind: zod_1.z.literal(exports.DeliverableTargetSlotKind.Repos),
+        repoSlug: zod_1.z
+            .string()
+            .min(1)
+            .regex(REPO_SLUG_PATTERN, 'repoSlug must be kebab/snake-case ([a-z0-9][a-z0-9-_]*)'),
+    })
+        .strict(),
+]);
+exports.DeliverableOutputContractSchema = zod_1.z
+    .object({
+    title: zod_1.z.string().min(1),
+    mode: zod_1.z.enum([
+        exports.DeliverableOutputContractMode.WorkspaceFiles,
+        exports.DeliverableOutputContractMode.ResponseOnly,
+        exports.DeliverableOutputContractMode.EndpointFetch,
+        exports.DeliverableOutputContractMode.NoOutput,
+    ]),
+    targetSlot: TargetSlotDescriptorSchema.optional(),
+    files: zod_1.z.array(FileEntrySchema).optional(),
+    multiPage: MultiPageSchema.optional(),
+    notes: zod_1.z.string().optional(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.mode === exports.DeliverableOutputContractMode.WorkspaceFiles) {
+        const hasFiles = Array.isArray(value.files) && value.files.length > 0;
+        const hasMultiPage = value.multiPage !== undefined;
+        if (!hasFiles && !hasMultiPage) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: "mode='workspace-files' requires either `files[]` or `multiPage{}` to declare what the agent must write",
+            });
+        }
+        if (value.targetSlot === undefined) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: "mode='workspace-files' requires `targetSlot` to declare which workspace slot the deliverable lands in (deliverables vs repos/<slug>)",
+            });
+        }
+    }
+    if (value.mode !== exports.DeliverableOutputContractMode.WorkspaceFiles) {
+        if (value.files !== undefined || value.multiPage !== undefined) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: `mode='${value.mode}' must not declare files[] or multiPage{}`,
+            });
+        }
+        if (value.targetSlot !== undefined) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: `mode='${value.mode}' must not declare targetSlot — only workspace-files contracts target a slot`,
+            });
+        }
+    }
+});
+//# sourceMappingURL=deliverable-output-contract.js.map

package/dist/lib/deliverable-output-contract.js.map

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

package/dist/lib/derive-required-workspace-slots.d.ts

@@ -0,0 +1,12 @@
+import { SlotMode, type WorkspaceSpec } from '@xemahq/agent-workspace-contracts';
+import { type DeliverableOutputContract } from './deliverable-output-contract';
+export type RequiredWorkspaceSlot = {
+    readonly key: 'deliverables';
+    readonly mode: SlotMode;
+} | {
+    readonly key: 'repos';
+    readonly mode: SlotMode;
+    readonly repoSlug: string;
+};
+export declare function deriveRequiredWorkspaceSlots(contract: DeliverableOutputContract | null, spec: WorkspaceSpec): readonly RequiredWorkspaceSlot[];
+//# sourceMappingURL=derive-required-workspace-slots.d.ts.map

package/dist/lib/derive-required-workspace-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-required-workspace-slots.d.ts","sourceRoot":"","sources":["../../src/lib/derive-required-workspace-slots.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EACR,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,+BAA+B,CAAC;AAOvC,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AA2BN,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,yBAAyB,GAAG,IAAI,EAC1C,IAAI,EAAE,aAAa,GAClB,SAAS,qBAAqB,EAAE,CAalC"}

package/dist/lib/derive-required-workspace-slots.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveRequiredWorkspaceSlots = deriveRequiredWorkspaceSlots;
+const agent_workspace_contracts_1 = require("@xemahq/agent-workspace-contracts");
+const deliverable_output_contract_1 = require("./deliverable-output-contract");
+function deriveRequiredWorkspaceSlots(contract, spec) {
+    if (!contract || contract.mode !== 'workspace-files') {
+        return [];
+    }
+    if (contract.targetSlot === undefined) {
+        throw new Error(`deliverable contract has mode='workspace-files' but no targetSlot — producing kind handler is missing the structured descriptor`);
+    }
+    return [buildRequiredSlot(contract.targetSlot, spec)];
+}
+function buildRequiredSlot(descriptor, spec) {
+    const slotKey = slotKeyForDescriptor(descriptor);
+    const slot = (0, agent_workspace_contracts_1.findSlot)(spec, slotKey);
+    if (!slot) {
+        throw new Error(`deliverable contract targetSlot.kind='${descriptor.kind}' resolves to slot '${slotKey}', not declared in WorkspaceSpec '${spec.id}'`);
+    }
+    if (slot.singleFile === true) {
+        throw new Error(`deliverable contract targetSlot.kind='${descriptor.kind}' resolves to single-file slot '${slotKey}', which cannot host arbitrary deliverables`);
+    }
+    if (!slot.allowedModes.includes(agent_workspace_contracts_1.SlotMode.ReadWrite)) {
+        throw new Error(`deliverable contract targetSlot.kind='${descriptor.kind}' resolves to slot '${slotKey}' which does not allow read-write (allowedModes=[${slot.allowedModes.join(', ')}])`);
+    }
+    if (descriptor.kind === deliverable_output_contract_1.DeliverableTargetSlotKind.Repos) {
+        return {
+            key: 'repos',
+            mode: agent_workspace_contracts_1.SlotMode.ReadWrite,
+            repoSlug: descriptor.repoSlug,
+        };
+    }
+    return {
+        key: 'deliverables',
+        mode: agent_workspace_contracts_1.SlotMode.ReadWrite,
+    };
+}
+function slotKeyForDescriptor(descriptor) {
+    switch (descriptor.kind) {
+        case deliverable_output_contract_1.DeliverableTargetSlotKind.Deliverables:
+            return 'deliverables';
+        case deliverable_output_contract_1.DeliverableTargetSlotKind.Repos:
+            return 'repos';
+        default: {
+            const exhaustive = descriptor;
+            throw new Error(`unhandled DeliverableTargetSlotKind '${String(exhaustive?.kind)}'`);
+        }
+    }
+}
+//# sourceMappingURL=derive-required-workspace-slots.js.map

package/dist/lib/derive-required-workspace-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-required-workspace-slots.js","sourceRoot":"","sources":["../../src/lib/derive-required-workspace-slots.ts"],"names":[],"mappings":";;AAqDA,oEAgBC;AArED,iFAI2C;AAE3C,+EAIuC;AA2CvC,SAAgB,4BAA4B,CAC1C,QAA0C,EAC1C,IAAmB;IAEnB,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACrD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAItC,MAAM,IAAI,KAAK,CACb,iIAAiI,CAClI,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,iBAAiB,CACxB,UAA2C,EAC3C,IAAmB;IAEnB,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAA,oCAAQ,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,IAAI,uBAAuB,OAAO,qCAAqC,IAAI,CAAC,EAAE,GAAG,CACtI,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,IAAI,mCAAmC,OAAO,6CAA6C,CAChJ,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,oCAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,yCAAyC,UAAU,CAAC,IAAI,uBAAuB,OAAO,oDAAoD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAC3K,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,uDAAyB,CAAC,KAAK,EAAE,CAAC;QACxD,OAAO;YACL,GAAG,EAAE,OAAO;YACZ,IAAI,EAAE,oCAAQ,CAAC,SAAS;YACxB,QAAQ,EAAE,UAAU,CAAC,QAAQ;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,oCAAQ,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,UAA2C;IAE3C,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,uDAAyB,CAAC,YAAY;YACzC,OAAO,cAAc,CAAC;QACxB,KAAK,uDAAyB,CAAC,KAAK;YAClC,OAAO,OAAO,CAAC;QACjB,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,UAAU,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAE,UAAiC,EAAE,IAAI,CAAC,GAAG,CAC5F,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lib/encryption.d.ts

@@ -0,0 +1,5 @@
+export declare function createEncryptionPair(keyHex: string): {
+    encrypt: (plaintext: string) => string;
+    decrypt: (encoded: string) => string;
+};
+//# sourceMappingURL=encryption.d.ts.map

package/dist/lib/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/lib/encryption.ts"],"names":[],"mappings":"AAyBA,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;IACpD,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACtC,CAqCA"}