@xenosystem/agent-sdk 0.8.12

package/dist/control-plane/index.d.ts

@@ -0,0 +1,403 @@
+type AgentRunStatus = "queued" | "starting" | "running" | "blocked" | "waiting_for_user" | "waiting_for_tool" | "waiting_for_hook" | "waiting_for_permission" | "paused" | "completed" | "failed" | "cancelled" | "interrupted" | "detached";
+interface AgentRunUsage {
+    input: number;
+    output: number;
+    total: number;
+    estimatedCostUsd?: number;
+}
+interface AgentRunAgentDefinitionRef {
+    name: string;
+    scope: "project" | "user" | "plugin" | "built-in";
+    path: string;
+    description?: string;
+    model?: string;
+}
+interface AgentRunRecord {
+    schemaVersion: 1;
+    runId: string;
+    sessionId: string;
+    rootRunId: string;
+    parentRunId?: string;
+    cwd: string;
+    workspaceId: string;
+    prompt: string;
+    title?: string;
+    status: AgentRunStatus;
+    statusReason?: string;
+    blockedReason?: string;
+    model: string;
+    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+    agent?: AgentRunAgentDefinitionRef;
+    permissionMode: "default" | "plan" | "acceptEdits" | "auto" | "dontAsk" | "bypassPermissions";
+    createdByCliVersion?: string;
+    createdBySdkVersion?: string;
+    createdAt: string;
+    updatedAt: string;
+    startedAt?: string;
+    endedAt?: string;
+    lastActivityAt?: string;
+    pinned: boolean;
+    attachedClients: number;
+    workerPid?: number;
+    workerVersion?: string;
+    cliVersion?: string;
+    sdkVersion?: string;
+    stdoutPath: string;
+    stderrPath: string;
+    eventsPath: string;
+    exitCode?: number | null;
+    git?: {
+        root?: string;
+        originBranch?: string;
+        originCommit?: string;
+        branch?: string;
+        baseRef?: string;
+        commit?: string;
+        worktree?: string;
+    };
+    usage: AgentRunUsage;
+    children: string[];
+    tags: string[];
+}
+interface AgentRunEvent {
+    schemaVersion: 1;
+    eventId?: string;
+    sequence?: number;
+    runId: string;
+    type: string;
+    timestamp: string;
+    payload: Record<string, unknown>;
+}
+interface AgentRunListOptions {
+    cwd?: string;
+    all?: boolean;
+    status?: AgentRunStatus[];
+    limit?: number;
+}
+interface AgentRunCreateInput {
+    prompt: string;
+    cwd: string;
+    model: string;
+    effort?: AgentRunRecord["effort"];
+    agent?: AgentRunAgentDefinitionRef;
+    permissionMode: AgentRunRecord["permissionMode"];
+    title?: string;
+    pinned?: boolean;
+    git?: AgentRunRecord["git"];
+    cliVersion?: string;
+    sdkVersion?: string;
+}
+declare function getAgentRunStoreDir(): string;
+declare function getAgentRunDir(runId: string): string;
+declare function createAgentRunId(date?: Date): string;
+declare class AgentRunStore {
+    private readonly runsDir;
+    private readonly eventStore;
+    constructor(runsDir?: string);
+    create(input: AgentRunCreateInput): AgentRunRecord;
+    get(runId: string): AgentRunRecord | null;
+    list(options?: AgentRunListOptions): AgentRunRecord[];
+    markSpawned(runId: string, pid: number, workerVersion?: string): AgentRunRecord | null;
+    markStarted(runId: string, input: {
+        pid: number;
+        workerVersion?: string;
+        model?: string;
+        effort?: AgentRunRecord["effort"];
+    }): AgentRunRecord | null;
+    markCompleted(runId: string, input: {
+        status: AgentRunStatus;
+        statusReason?: string;
+        exitCode?: number | null;
+        usage?: AgentRunUsage;
+    }): AgentRunRecord | null;
+    markCancelled(runId: string, reason: string): AgentRunRecord | null;
+    markPaused(runId: string, reason?: string): AgentRunRecord | null;
+    markResumed(runId: string, reason?: string): AgentRunRecord | null;
+    setPinned(runId: string, pinned: boolean): AgentRunRecord | null;
+    appendEvent(runId: string, type: string, payload?: Record<string, unknown>): void;
+    readEvents(runId: string): AgentRunEvent[];
+    delete(runId: string): void;
+    refreshRecordStatus(record: AgentRunRecord): AgentRunRecord;
+    private update;
+    private write;
+    private recordPath;
+    private runDir;
+}
+declare class AgentEventStore {
+    private readonly runsDir;
+    constructor(runsDir: string);
+    pathFor(runId: string): string;
+    append(runId: string, type: string, payload?: Record<string, unknown>, timestamp?: string): AgentRunEvent;
+    read(runId: string): AgentRunEvent[];
+    tail(runId: string, limit?: number): AgentRunEvent[];
+}
+interface AgentRunSpawnResult {
+    pid: number;
+    workerVersion?: string;
+}
+interface AgentRunControllerOptions {
+    store?: AgentRunStore;
+    spawn?: (record: AgentRunRecord) => AgentRunSpawnResult | Promise<AgentRunSpawnResult>;
+    stop?: (record: AgentRunRecord, reason: string) => void | Promise<void>;
+    pause?: (record: AgentRunRecord, reason: string) => void | Promise<void>;
+    resume?: (record: AgentRunRecord, reason: string) => void | Promise<void>;
+}
+declare class AgentRunController {
+    private readonly options;
+    readonly store: AgentRunStore;
+    constructor(options?: AgentRunControllerOptions);
+    create(input: AgentRunCreateInput): AgentRunRecord;
+    start(input: AgentRunCreateInput): Promise<AgentRunRecord>;
+    get(runId: string): AgentRunRecord | null;
+    list(options?: AgentRunListOptions): AgentRunRecord[];
+    events(runId: string, limit?: number): AgentRunEvent[];
+    stop(runId: string, reason?: string): Promise<AgentRunRecord | null>;
+    pause(runId: string, reason?: string): Promise<AgentRunRecord | null>;
+    resume(runId: string, reason?: string): Promise<AgentRunRecord | null>;
+    complete(runId: string, status: Extract<AgentRunStatus, "completed" | "failed" | "interrupted">, options?: {
+        reason?: string;
+        exitCode?: number | null;
+        usage?: AgentRunUsage;
+    }): AgentRunRecord | null;
+}
+declare const AGENT_DAEMON_PROTOCOL_VERSION: 1;
+interface AgentDaemonRequest<T = unknown> {
+    protocolVersion: typeof AGENT_DAEMON_PROTOCOL_VERSION;
+    id: string;
+    method: string;
+    params: T;
+    authToken?: string;
+}
+interface AgentDaemonError {
+    code: string;
+    message: string;
+}
+type AgentDaemonResponse<T = unknown> = {
+    protocolVersion: 1;
+    id: string;
+    result: T;
+} | {
+    protocolVersion: 1;
+    id: string;
+    error: AgentDaemonError;
+};
+type AgentDaemonHandler = (params: unknown, request: AgentDaemonRequest) => unknown | Promise<unknown>;
+type AgentDaemonTransport = (request: AgentDaemonRequest) => AgentDaemonResponse | Promise<AgentDaemonResponse>;
+declare class AgentDaemonServer {
+    private readonly options;
+    private readonly handlers;
+    constructor(options?: {
+        authToken?: string;
+    });
+    register(method: string, handler: AgentDaemonHandler): this;
+    registerController(controller: AgentRunController): this;
+    handle(request: AgentDaemonRequest): Promise<AgentDaemonResponse>;
+    private error;
+}
+declare class AgentDaemonClient {
+    private readonly transport;
+    private readonly options;
+    constructor(transport: AgentDaemonTransport, options?: {
+        authToken?: string;
+    });
+    request<TResult = unknown, TParams = unknown>(method: string, params: TParams): Promise<TResult>;
+}
+interface WorkflowNodeDefinition {
+    id: string;
+    dependsOn?: string[];
+    input?: unknown;
+}
+interface WorkflowDefinition {
+    schemaVersion: 1;
+    id: string;
+    name: string;
+    nodes: WorkflowNodeDefinition[];
+    maxConcurrency?: number;
+    failFast?: boolean;
+}
+type WorkflowNodeStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+type WorkflowRunStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
+interface WorkflowRunNodeRecord {
+    status: WorkflowNodeStatus;
+    startedAt?: string;
+    completedAt?: string;
+    output?: unknown;
+    error?: string;
+}
+interface WorkflowRunRecord {
+    schemaVersion: 1;
+    runId: string;
+    workflowId: string;
+    status: WorkflowRunStatus;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    nodes: Record<string, WorkflowRunNodeRecord>;
+}
+interface WorkflowEvent {
+    schemaVersion: 1;
+    eventId: string;
+    runId: string;
+    type: string;
+    timestamp: string;
+    nodeId?: string;
+    payload: Record<string, unknown>;
+}
+interface WorkflowPlan {
+    workflowId: string;
+    waves: string[][];
+}
+declare class WorkflowPlanner {
+    plan(definition: WorkflowDefinition): WorkflowPlan;
+}
+declare class WorkflowStore {
+    private readonly rootDir;
+    constructor(rootDir?: string);
+    saveDefinition(definition: WorkflowDefinition): WorkflowDefinition;
+    getDefinition(id: string): WorkflowDefinition | null;
+    listDefinitions(): WorkflowDefinition[];
+    createRun(definition: WorkflowDefinition): WorkflowRunRecord;
+    getRun(runId: string): WorkflowRunRecord | null;
+    updateRun(runId: string, updater: (record: WorkflowRunRecord) => WorkflowRunRecord): WorkflowRunRecord;
+    appendEvent(runId: string, type: string, payload: Record<string, unknown>, nodeId?: string): WorkflowEvent;
+    readEvents(runId: string): WorkflowEvent[];
+    private writeRun;
+    private definitionsDir;
+    private runsDir;
+    private runPath;
+    private eventsPath;
+}
+type WorkflowNodeExecutor = (node: WorkflowNodeDefinition, context: {
+    run: WorkflowRunRecord;
+    definition: WorkflowDefinition;
+}) => unknown | Promise<unknown>;
+declare class WorkflowRuntime {
+    private readonly store;
+    private readonly planner;
+    constructor(store?: WorkflowStore, planner?: WorkflowPlanner);
+    run(definition: WorkflowDefinition, executor: WorkflowNodeExecutor): Promise<WorkflowRunRecord>;
+}
+interface MonitorEvent {
+    schemaVersion: 1;
+    eventId: string;
+    sourceId: string;
+    type: string;
+    timestamp: string;
+    payload: Record<string, unknown>;
+}
+interface MonitorSource {
+    id: string;
+    start?(): void | Promise<void>;
+    poll(): Array<Omit<MonitorEvent, "schemaVersion" | "eventId" | "sourceId" | "timestamp"> & {
+        timestamp?: string;
+    }> | Promise<Array<Omit<MonitorEvent, "schemaVersion" | "eventId" | "sourceId" | "timestamp"> & {
+        timestamp?: string;
+    }>>;
+    stop?(): void | Promise<void>;
+}
+interface MonitorSnapshot {
+    sourceId: string;
+    running: boolean;
+    events: MonitorEvent[];
+}
+declare class MonitorManager {
+    private readonly maxEvents;
+    private readonly sources;
+    private readonly events;
+    constructor(maxEvents?: number);
+    register(source: MonitorSource): this;
+    start(sourceId: string, intervalMs?: number): Promise<MonitorSnapshot>;
+    poll(sourceId: string): Promise<MonitorEvent[]>;
+    stop(sourceId: string): Promise<MonitorSnapshot>;
+    stopAll(): Promise<void>;
+    snapshot(sourceId: string, limit?: number): MonitorSnapshot;
+    list(): Array<{
+        sourceId: string;
+        running: boolean;
+    }>;
+    private require;
+}
+declare class MonitorTool {
+    private readonly manager;
+    constructor(manager: MonitorManager);
+    execute(input: {
+        sourceId: string;
+        intervalMs?: number;
+    }): Promise<MonitorSnapshot>;
+}
+declare class MonitorStopTool {
+    private readonly manager;
+    constructor(manager: MonitorManager);
+    execute(input: {
+        sourceId: string;
+    }): Promise<MonitorSnapshot>;
+}
+interface UsageAttribution {
+    runId?: string;
+    sessionId?: string;
+    workflowRunId?: string;
+    agentId?: string;
+    provider?: string;
+    model?: string;
+}
+interface UsageEvent extends UsageAttribution {
+    schemaVersion: 1;
+    eventId: string;
+    timestamp: string;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens?: number;
+    estimatedCostUsd?: number;
+    metadata?: Record<string, string | number | boolean>;
+}
+interface UsageQuery extends UsageAttribution {
+    from?: string;
+    to?: string;
+}
+interface UsageTotals {
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cachedInputTokens: number;
+    estimatedCostUsd: number;
+    events: number;
+}
+declare class UsageAccumulator {
+    private totalsValue;
+    add(event: Pick<UsageEvent, "inputTokens" | "outputTokens" | "cachedInputTokens" | "estimatedCostUsd">): this;
+    snapshot(): UsageTotals;
+}
+declare class UsageLedger {
+    private readonly path;
+    constructor(path?: string);
+    append(input: Omit<UsageEvent, "schemaVersion" | "eventId" | "timestamp"> & {
+        timestamp?: string;
+    }): UsageEvent;
+    query(query?: UsageQuery): UsageEvent[];
+    summarize(query?: UsageQuery): UsageTotals;
+}
+interface OtelUsageAdapter {
+    addCounter(name: string, value: number, attributes: Readonly<Record<string, string>>): void;
+    recordEvent?(name: string, attributes: Readonly<Record<string, string>>): void;
+}
+declare class OtelExporter {
+    private readonly adapter;
+    constructor(adapter: OtelUsageAdapter);
+    export(events: readonly UsageEvent[]): void;
+}
+interface ControlPlaneLockRecord {
+    schemaVersion: 1;
+    name: string;
+    pid: number;
+    hostname: string;
+    processStartedAt: string;
+    version: string;
+    acquiredAt: string;
+    updatedAt: string;
+}
+interface ControlPlaneLockHandle {
+    record: ControlPlaneLockRecord;
+    release: () => void;
+}
+declare function acquireControlPlaneLock(path: string, name: string, version: string): ControlPlaneLockHandle;
+export { AGENT_DAEMON_PROTOCOL_VERSION, AgentDaemonClient, type AgentDaemonError, type AgentDaemonHandler, type AgentDaemonRequest, type AgentDaemonResponse, AgentDaemonServer, type AgentDaemonTransport, AgentEventStore, type AgentRunAgentDefinitionRef, AgentRunController, type AgentRunControllerOptions, type AgentRunCreateInput, type AgentRunEvent, type AgentRunListOptions, type AgentRunRecord, type AgentRunSpawnResult, type AgentRunStatus, AgentRunStore, type AgentRunUsage, type ControlPlaneLockHandle, type ControlPlaneLockRecord, type MonitorEvent, MonitorManager, type MonitorSnapshot, type MonitorSource, MonitorStopTool, MonitorTool, OtelExporter, type OtelUsageAdapter, UsageAccumulator, type UsageAttribution, type UsageEvent, UsageLedger, type UsageQuery, type UsageTotals, type WorkflowDefinition, type WorkflowEvent, type WorkflowNodeDefinition, type WorkflowNodeExecutor, type WorkflowNodeStatus, type WorkflowPlan, WorkflowPlanner, type WorkflowRunNodeRecord, type WorkflowRunRecord, type WorkflowRunStatus, WorkflowRuntime, WorkflowStore, acquireControlPlaneLock, createAgentRunId, getAgentRunDir, getAgentRunStoreDir };

package/dist/control-plane/index.js

@@ -0,0 +1,7 @@
+import{randomUUID as Ee}from"node:crypto";import{existsSync as De,mkdirSync as b,readFileSync as xe,readdirSync as Ie,renameSync as Te,rmSync as Pe,writeFileSync as S}from"node:fs";import{homedir as be}from"node:os";import{basename as H,dirname as Oe,join as c,resolve as _e}from"node:path";var h="0.8.11";import{mkdirSync as ue,readFileSync as de,rmSync as $,writeFileSync as ce}from"node:fs";import{hostname as L}from"node:os";import{dirname as le}from"node:path";function pe(){return new Date().toISOString()}function ge(){return new Date(Date.now()-Math.floor(process.uptime()*1e3)).toISOString()}function F(n){try{return JSON.parse(de(n,"utf8"))}catch{return null}}function me(n){if(!n||n<=0)return!1;try{return process.kill(n,0),!0}catch{return!1}}function fe(n){return n.hostname!==L()?!0:me(n.pid)}function W(n,e){ue(le(n),{recursive:!0}),ce(n,JSON.stringify(e,null,2)+`
+`,{encoding:"utf8",flag:"wx"})}function he(n,e){let t=F(n);t?.pid!==e.pid||t.hostname!==e.hostname||$(n,{force:!0})}function k(n,e,t){let r=pe(),o={schemaVersion:1,name:e,pid:process.pid,hostname:L(),processStartedAt:ge(),version:t,acquiredAt:r,updatedAt:r};try{W(n,o)}catch(i){if(i.code!=="EEXIST")throw i;let a=F(n);if(a&&fe(a))throw new Error(`${e} is already locked by PID ${a.pid} on ${a.hostname}.`);$(n,{force:!0}),W(n,o)}return{record:o,release:()=>{he(n,o)}}}import{randomUUID as Re}from"node:crypto";import{appendFileSync as we,existsSync as ve,mkdirSync as j,readFileSync as ke}from"node:fs";import{basename as Ae,dirname as ye,join as Se}from"node:path";function J(n){return Ae(n).replace(/[^A-Za-z0-9_.-]/g,"_").slice(0,96)}function q(n){return ve(n)?ke(n,"utf8").split(/\r?\n/).map(e=>e.trim()).filter(Boolean).map(e=>{try{return JSON.parse(e)}catch{return null}}).filter(e=>e!==null):[]}var A=class{constructor(e){this.runsDir=e;j(this.runsDir,{recursive:!0})}runsDir;pathFor(e){return Se(this.runsDir,J(e),"events.jsonl")}append(e,t,r={},o=new Date().toISOString()){let i=this.pathFor(e);j(ye(i),{recursive:!0});let s=k(`${i}.lock`,`events:${J(e)}`,h);try{let a=q(i).reduce((T,l,v)=>Math.max(T,l.sequence??v),-1)+1,p={schemaVersion:1,eventId:`event_${Re()}`,sequence:a,runId:e,type:t,timestamp:o,payload:r};return we(i,`${JSON.stringify(p)}
+`,"utf8"),p}finally{s.release()}}read(e){return q(this.pathFor(e))}tail(e,t=100){let r=Math.max(0,Math.min(1e4,Math.trunc(t)));return r===0?[]:this.read(e).slice(-r)}};var Ce=1,Ue=c(be(),".xeno-agent"),Me=c(process.env.XENO_AGENT_HOME??Ue,"daemon"),_=c(Me,"runs");function d(){return new Date().toISOString()}function Ne(n=new Date){return n.toISOString().replace(/[^0-9]/g,"").slice(0,14)}function O(n){return n.replace(/[^A-Za-z0-9_.-]/g,"_").slice(0,80)}function C(n){return _e(n)}function E(n){return C(n).toLowerCase()}function z(n,e){let t=E(n),r=E(e);return t===r||t.startsWith(`${r}\\`)||t.startsWith(`${r}/`)}function Ve(n,e){return!!(E(n.cwd)===E(e)||n.git?.root&&z(e,n.git.root)||n.git?.worktree&&z(e,n.git.worktree))}function We(n){return O(Buffer.from(C(n)).toString("base64url"))}function $e(){return{input:0,output:0,total:0}}function y(n){try{return JSON.parse(xe(n,"utf8"))}catch{return null}}function Le(n){return n instanceof Error&&/\balready locked by PID\b/.test(n.message)}function Fe(n,e){b(Oe(n),{recursive:!0});let t=`${n}.${process.pid}.${Date.now()}.tmp`;S(t,JSON.stringify(e,null,2)+`
+`,"utf8"),Te(t,n)}function je(n){if(!n||n<=0)return!1;try{return process.kill(n,0),!0}catch{return!1}}function Je(n){return n==="completed"||n==="failed"||n==="cancelled"||n==="interrupted"}function qe(n,e){return n.pinned!==e.pinned?n.pinned?-1:1:Date.parse(e.updatedAt)-Date.parse(n.updatedAt)}function bt(){return _}function Ot(n){return c(_,n)}function He(n=new Date){return`run_${Ne(n)}_${Ee().slice(0,8)}`}var D=class{constructor(e=_){this.runsDir=e;b(this.runsDir,{recursive:!0}),this.eventStore=new A(this.runsDir)}runsDir;eventStore;create(e){let t=He(),r=c(this.runsDir,t);b(r,{recursive:!0});let o=d(),i=c(r,"events.jsonl"),s={schemaVersion:Ce,runId:t,sessionId:t,rootRunId:t,cwd:C(e.cwd),workspaceId:We(e.cwd),prompt:e.prompt,...e.title?{title:e.title}:{},status:"starting",model:e.model,...e.effort?{effort:e.effort}:{},...e.agent?{agent:e.agent}:{},...e.git?{git:e.git}:{},permissionMode:e.permissionMode,...e.cliVersion?{createdByCliVersion:e.cliVersion}:{},createdBySdkVersion:e.sdkVersion??h,createdAt:o,updatedAt:o,lastActivityAt:o,pinned:!!e.pinned,attachedClients:0,...e.cliVersion?{cliVersion:e.cliVersion}:{},...e.sdkVersion?{sdkVersion:e.sdkVersion}:{},stdoutPath:c(r,"stdout.log"),stderrPath:c(r,"stderr.log"),eventsPath:i,usage:$e(),children:[],tags:[]};return S(s.stdoutPath,"","utf8"),S(s.stderrPath,"","utf8"),S(s.eventsPath,"","utf8"),this.write(s),this.appendEvent(t,"run_created",{cwd:s.cwd,model:s.model,...s.agent?{agent:s.agent}:{},...s.git?{git:s.git}:{},permissionMode:s.permissionMode,pinned:s.pinned}),s}get(e){let t=y(this.recordPath(e));return t?this.refreshRecordStatus(t):null}list(e={}){if(!De(this.runsDir))return[];let t=Ie(this.runsDir,{withFileTypes:!0}).filter(r=>r.isDirectory()).map(r=>{try{return this.get(r.name)}catch(o){if(Le(o))return y(this.recordPath(r.name));throw o}}).filter(r=>r!==null).filter(r=>e.all||!e.cwd||Ve(r,e.cwd)).filter(r=>!e.status||e.status.includes(r.status)).sort(qe);return typeof e.limit=="number"&&e.limit>0?t.slice(0,e.limit):t}markSpawned(e,t,r){return this.update(e,o=>({...o,status:"running",workerPid:t,...r?{workerVersion:r}:{},startedAt:o.startedAt??d(),lastActivityAt:d()}))}markStarted(e,t){return this.update(e,r=>({...r,status:"running",workerPid:t.pid,...t.workerVersion?{workerVersion:t.workerVersion}:{},...t.model?{model:t.model}:{},...t.effort?{effort:t.effort}:{},startedAt:r.startedAt??d(),lastActivityAt:d()}))}markCompleted(e,t){return this.update(e,r=>({...r,status:t.status,...t.statusReason?{statusReason:t.statusReason}:{},exitCode:t.exitCode??null,usage:t.usage??r.usage,endedAt:d(),lastActivityAt:d()}))}markCancelled(e,t){return this.update(e,r=>({...r,status:"cancelled",statusReason:t,endedAt:d(),lastActivityAt:d()}))}markPaused(e,t="Paused by user."){let r=this.update(e,o=>({...o,status:"paused",statusReason:t,lastActivityAt:d()}));return r&&this.appendEvent(e,"run_paused",{reason:t}),r}markResumed(e,t="Resumed by user."){let r=this.update(e,o=>{let i={...o,status:"running",statusReason:t,lastActivityAt:d()};return delete i.endedAt,delete i.exitCode,i});return r&&this.appendEvent(e,"run_resumed",{reason:t}),r}setPinned(e,t){let r=this.update(e,o=>({...o,pinned:t,lastActivityAt:d()}));return r&&this.appendEvent(e,t?"run_pinned":"run_unpinned",{pinned:t}),r}appendEvent(e,t,r={}){let o=y(this.recordPath(e)),i=this.eventStore.append(e,t,r);o&&this.update(e,s=>({...s,lastActivityAt:i.timestamp}))}readEvents(e){return this.get(e)?this.eventStore.read(e):[]}delete(e){Pe(c(this.runsDir,e),{recursive:!0,force:!0})}refreshRecordStatus(e){if(Je(e.status))return e;if(e.workerPid&&!je(e.workerPid)){let t={...e,status:"failed",statusReason:"Worker process is no longer running and did not record a terminal status.",endedAt:e.endedAt??d(),updatedAt:d()};return this.write(t),t}return e}update(e,t){let r=y(this.recordPath(e));if(!r)return null;let o=t(r);return o.updatedAt=d(),this.write(o),o}write(e){let t=k(c(this.runDir(e.runId),"run.lock"),`run:${e.runId}`,h);try{Fe(this.recordPath(e.runId),e)}finally{t.release()}}recordPath(e){return c(this.runsDir,O(H(e)),"run.json")}runDir(e){return c(this.runsDir,O(H(e)))}};function B(n){return n==="completed"||n==="failed"||n==="cancelled"||n==="interrupted"}var G=class{constructor(e={}){this.options=e;this.store=e.store??new D}options;store;create(e){return this.store.create(e)}async start(e){let t=this.create(e);if(!this.options.spawn)return t;try{let r=await this.options.spawn(t),o=this.store.markSpawned(t.runId,r.pid,r.workerVersion);if(!o)throw new Error(`Run disappeared during spawn: ${t.runId}`);return this.store.appendEvent(t.runId,"run_started",{pid:r.pid}),o}catch(r){let o=r instanceof Error?r.message:String(r);throw this.store.markCompleted(t.runId,{status:"failed",statusReason:o,exitCode:null}),this.store.appendEvent(t.runId,"run_start_failed",{reason:o}),r}}get(e){return this.store.get(e)}list(e={}){return this.store.list(e)}events(e,t){let r=this.store.readEvents(e);return t===void 0?r:r.slice(-Math.max(0,Math.trunc(t)))}async stop(e,t="Stopped by user."){let r=this.store.get(e);if(!r||B(r.status))return r;await this.options.stop?.(r,t);let o=this.store.markCancelled(e,t);return o&&this.store.appendEvent(e,"run_cancelled",{reason:t}),o}async pause(e,t="Paused by user."){let r=this.store.get(e);return!r||B(r.status)||r.status==="paused"?r:(await this.options.pause?.(r,t),this.store.markPaused(e,t))}async resume(e,t="Resumed by user."){let r=this.store.get(e);return!r||r.status!=="paused"?r:(await this.options.resume?.(r,t),this.store.markResumed(e,t))}complete(e,t,r={}){let o=this.store.markCompleted(e,{status:t,...r.reason?{statusReason:r.reason}:{},...r.exitCode!==void 0?{exitCode:r.exitCode}:{},...r.usage?{usage:r.usage}:{}});return o&&this.store.appendEvent(e,`run_${t}`,{...r.reason?{reason:r.reason}:{}}),o}};import{randomUUID as ze,timingSafeEqual as Be}from"node:crypto";var R=1;function Ge(n,e){if(!n)return!1;let t=Buffer.from(n),r=Buffer.from(e);return t.length===r.length&&Be(t,r)}var Q=class{constructor(e={}){this.options=e}options;handlers=new Map;register(e,t){let r=e.trim();if(!r)throw new Error("Daemon method name cannot be empty.");if(this.handlers.has(r))throw new Error(`Daemon method already registered: ${r}`);return this.handlers.set(r,t),this}registerController(e){return this.register("runs.start",t=>e.start(t)).register("runs.get",t=>e.get(t.runId)).register("runs.list",t=>e.list(t??{})).register("runs.events",t=>{let r=t;return e.events(r.runId,r.limit)}).register("runs.stop",t=>{let r=t;return e.stop(r.runId,r.reason)}).register("runs.pause",t=>{let r=t;return e.pause(r.runId,r.reason)}).register("runs.resume",t=>{let r=t;return e.resume(r.runId,r.reason)})}async handle(e){if(e.protocolVersion!==R)return this.error(e.id,"PROTOCOL_MISMATCH",`Unsupported protocol version: ${e.protocolVersion}`);if(this.options.authToken&&!Ge(e.authToken,this.options.authToken))return this.error(e.id,"UNAUTHORIZED","Daemon authentication failed.");let t=this.handlers.get(e.method);if(!t)return this.error(e.id,"METHOD_NOT_FOUND",`Unknown daemon method: ${e.method}`);try{return{protocolVersion:R,id:e.id,result:await t(e.params,e)}}catch(r){return this.error(e.id,"INTERNAL_ERROR",r instanceof Error?r.message:String(r))}}error(e,t,r){return{protocolVersion:R,id:e,error:{code:t,message:r}}}},X=class{constructor(e,t={}){this.transport=e;this.options=t}transport;options;async request(e,t){let r={protocolVersion:R,id:`request_${ze()}`,method:e,params:t,...this.options.authToken?{authToken:this.options.authToken}:{}},o=await this.transport(r);if(o.protocolVersion!==R||o.id!==r.id)throw new Error("Invalid daemon response identity.");if("error"in o){let i=new Error(o.error.message);throw i.code=o.error.code,i}return o.result}};import{randomUUID as Z}from"node:crypto";import{appendFileSync as Qe,existsSync as Xe,mkdirSync as I,readFileSync as ee,readdirSync as Ze,renameSync as Ke,writeFileSync as Ye}from"node:fs";import{homedir as et}from"node:os";import{basename as tt,dirname as te,join as g}from"node:path";function x(n){return tt(n).replace(/[^A-Za-z0-9_.-]/g,"_").slice(0,96)}function U(n){try{return JSON.parse(ee(n,"utf8"))}catch{return null}}function K(n,e){I(te(n),{recursive:!0});let t=`${n}.${process.pid}.${Date.now()}.tmp`;Ye(t,`${JSON.stringify(e,null,2)}
+`,"utf8"),Ke(t,n)}var w=class{plan(e){if(e.schemaVersion!==1)throw new Error("Unsupported workflow schema version.");if(!e.id.trim()||!e.name.trim())throw new Error("Workflow id and name are required.");let t=new Map;for(let s of e.nodes){if(!s.id.trim())throw new Error("Workflow node id cannot be empty.");if(t.has(s.id))throw new Error(`Duplicate workflow node: ${s.id}`);t.set(s.id,s)}for(let s of e.nodes)for(let a of s.dependsOn??[]){if(!t.has(a))throw new Error(`Workflow node ${s.id} depends on unknown node ${a}.`);if(a===s.id)throw new Error(`Workflow node ${s.id} cannot depend on itself.`)}let r=new Set(t.keys()),o=new Set,i=[];for(;r.size>0;){let s=[...r].filter(a=>(t.get(a)?.dependsOn??[]).every(p=>o.has(p))).sort();if(s.length===0)throw new Error("Workflow dependency graph contains a cycle.");i.push(s);for(let a of s)r.delete(a),o.add(a)}return{workflowId:e.id,waves:i}}},M=class{constructor(e=g(process.env.XENO_AGENT_HOME??g(et(),".xeno-agent"),"workflows")){this.rootDir=e;I(this.definitionsDir(),{recursive:!0}),I(this.runsDir(),{recursive:!0})}rootDir;saveDefinition(e){return new w().plan(e),K(g(this.definitionsDir(),`${x(e.id)}.json`),e),e}getDefinition(e){return U(g(this.definitionsDir(),`${x(e)}.json`))}listDefinitions(){return Ze(this.definitionsDir(),{withFileTypes:!0}).filter(e=>e.isFile()&&e.name.endsWith(".json")).map(e=>U(g(this.definitionsDir(),e.name))).filter(e=>e!==null)}createRun(e){new w().plan(e);let t=new Date().toISOString(),r={schemaVersion:1,runId:`workflow_run_${Z()}`,workflowId:e.id,status:"queued",createdAt:t,updatedAt:t,nodes:Object.fromEntries(e.nodes.map(o=>[o.id,{status:"pending"}]))};return this.writeRun(r),this.appendEvent(r.runId,"workflow_created",{}),r}getRun(e){return U(this.runPath(e))}updateRun(e,t){let r=this.getRun(e);if(!r)throw new Error(`Workflow run not found: ${e}`);let o=t(r);return o.updatedAt=new Date().toISOString(),this.writeRun(o),o}appendEvent(e,t,r,o){let i={schemaVersion:1,eventId:`workflow_event_${Z()}`,runId:e,type:t,timestamp:new Date().toISOString(),...o?{nodeId:o}:{},payload:r},s=this.eventsPath(e);return I(te(s),{recursive:!0}),Qe(s,`${JSON.stringify(i)}
+`,"utf8"),i}readEvents(e){let t=this.eventsPath(e);return Xe(t)?ee(t,"utf8").split(/\r?\n/).filter(Boolean).flatMap(r=>{try{return[JSON.parse(r)]}catch{return[]}}):[]}writeRun(e){K(this.runPath(e.runId),e)}definitionsDir(){return g(this.rootDir,"definitions")}runsDir(){return g(this.rootDir,"runs")}runPath(e){return g(this.runsDir(),x(e),"run.json")}eventsPath(e){return g(this.runsDir(),x(e),"events.jsonl")}},Y=class{constructor(e=new M,t=new w){this.store=e;this.planner=t}store;planner;async run(e,t){let r=this.planner.plan(e),o=this.store.createRun(e);o=this.store.updateRun(o.runId,a=>({...a,status:"running"})),this.store.appendEvent(o.runId,"workflow_started",{waves:r.waves.length});let i=Math.max(1,Math.trunc(e.maxConcurrency??4)),s=!1;for(let a of r.waves)for(let p=0;p<a.length;p+=i){let T=a.slice(p,p+i);await Promise.all(T.map(async l=>{let v=e.nodes.find(u=>u.id===l);if((v.dependsOn??[]).some(u=>this.store.getRun(o.runId)?.nodes[u]?.status!=="completed")||s&&e.failFast!==!1){this.store.updateRun(o.runId,u=>({...u,nodes:{...u.nodes,[l]:{status:"skipped",completedAt:new Date().toISOString()}}})),this.store.appendEvent(o.runId,"node_skipped",{},l);return}let P=new Date().toISOString();o=this.store.updateRun(o.runId,u=>({...u,nodes:{...u.nodes,[l]:{status:"running",startedAt:P}}})),this.store.appendEvent(o.runId,"node_started",{},l);try{let u=await t(v,{run:o,definition:e});this.store.updateRun(o.runId,f=>({...f,nodes:{...f.nodes,[l]:{status:"completed",startedAt:P,completedAt:new Date().toISOString(),output:u}}})),this.store.appendEvent(o.runId,"node_completed",{},l)}catch(u){s=!0;let f=u instanceof Error?u.message:String(u);this.store.updateRun(o.runId,V=>({...V,nodes:{...V.nodes,[l]:{status:"failed",startedAt:P,completedAt:new Date().toISOString(),error:f}}})),this.store.appendEvent(o.runId,"node_failed",{error:f},l)}}))}return o=this.store.updateRun(o.runId,a=>({...a,status:s?"failed":"completed",completedAt:new Date().toISOString()})),this.store.appendEvent(o.runId,s?"workflow_failed":"workflow_completed",{}),o}};import{randomUUID as rt}from"node:crypto";var re=class{constructor(e=1e4){this.maxEvents=e;if(!Number.isInteger(e)||e<1)throw new Error("maxEvents must be a positive integer.")}maxEvents;sources=new Map;events=[];register(e){if(!e.id.trim())throw new Error("Monitor source id cannot be empty.");if(this.sources.has(e.id))throw new Error(`Monitor source already registered: ${e.id}`);return this.sources.set(e.id,{source:e,running:!1}),this}async start(e,t=1e3){let r=this.require(e);if(r.running)return this.snapshot(e);await r.source.start?.(),r.running=!0,await this.poll(e);let o=Math.max(25,Math.trunc(t));return r.timer=setInterval(()=>{this.poll(e).catch(()=>{})},o),r.timer.unref?.(),this.snapshot(e)}async poll(e){let o=(await this.require(e).source.poll()).map(i=>({schemaVersion:1,eventId:`monitor_event_${rt()}`,sourceId:e,type:i.type,timestamp:i.timestamp??new Date().toISOString(),payload:i.payload}));return this.events.push(...o),this.events.length>this.maxEvents&&this.events.splice(0,this.events.length-this.maxEvents),o}async stop(e){let t=this.require(e);return t.timer&&clearInterval(t.timer),t.timer=void 0,t.running&&await t.source.stop?.(),t.running=!1,this.snapshot(e)}async stopAll(){await Promise.all([...this.sources.keys()].map(e=>this.stop(e)))}snapshot(e,t=100){let r=this.require(e);return{sourceId:e,running:r.running,events:this.events.filter(o=>o.sourceId===e).slice(-Math.max(0,Math.trunc(t)))}}list(){return[...this.sources].map(([e,t])=>({sourceId:e,running:t.running}))}require(e){let t=this.sources.get(e);if(!t)throw new Error(`Monitor source not found: ${e}`);return t}},ne=class{constructor(e){this.manager=e}manager;execute(e){return this.manager.start(e.sourceId,e.intervalMs)}},oe=class{constructor(e){this.manager=e}manager;execute(e){return this.manager.stop(e.sourceId)}};import{randomUUID as nt}from"node:crypto";import{appendFileSync as ot,existsSync as st,mkdirSync as it,readFileSync as at}from"node:fs";import{homedir as ut}from"node:os";import{dirname as dt,join as se}from"node:path";function m(n){return Number.isFinite(n)?Math.max(0,n??0):0}var N=class{totalsValue={inputTokens:0,outputTokens:0,totalTokens:0,cachedInputTokens:0,estimatedCostUsd:0,events:0};add(e){let t=m(e.inputTokens),r=m(e.outputTokens);return this.totalsValue.inputTokens+=t,this.totalsValue.outputTokens+=r,this.totalsValue.totalTokens+=t+r,this.totalsValue.cachedInputTokens+=m(e.cachedInputTokens),this.totalsValue.estimatedCostUsd+=m(e.estimatedCostUsd),this.totalsValue.events+=1,this}snapshot(){return{...this.totalsValue}}};function ct(n,e){if(["runId","sessionId","workflowRunId","agentId","provider","model"].some(o=>e[o]!==void 0&&n[o]!==e[o]))return!1;let r=Date.parse(n.timestamp);return!(e.from&&r<Date.parse(e.from)||e.to&&r>Date.parse(e.to))}var ie=class{path;constructor(e=se(process.env.XENO_AGENT_HOME??se(ut(),".xeno-agent"),"usage","events.jsonl")){this.path=e,it(dt(e),{recursive:!0})}append(e){let t={...e,schemaVersion:1,eventId:`usage_${nt()}`,timestamp:e.timestamp??new Date().toISOString(),inputTokens:m(e.inputTokens),outputTokens:m(e.outputTokens),...e.cachedInputTokens!==void 0?{cachedInputTokens:m(e.cachedInputTokens)}:{},...e.estimatedCostUsd!==void 0?{estimatedCostUsd:m(e.estimatedCostUsd)}:{}};return ot(this.path,`${JSON.stringify(t)}
+`,"utf8"),t}query(e={}){return st(this.path)?at(this.path,"utf8").split(/\r?\n/).filter(Boolean).flatMap(t=>{try{let r=JSON.parse(t);return ct(r,e)?[r]:[]}catch{return[]}}):[]}summarize(e={}){let t=new N;for(let r of this.query(e))t.add(r);return t.snapshot()}},ae=class{constructor(e){this.adapter=e}adapter;export(e){for(let t of e){let r={...t.provider?{provider:t.provider}:{},...t.model?{model:t.model}:{}};this.adapter.addCounter("xeno.usage.input_tokens",t.inputTokens,r),this.adapter.addCounter("xeno.usage.output_tokens",t.outputTokens,r),t.cachedInputTokens&&this.adapter.addCounter("xeno.usage.cached_input_tokens",t.cachedInputTokens,r),t.estimatedCostUsd&&this.adapter.addCounter("xeno.usage.estimated_cost_usd",t.estimatedCostUsd,r),this.adapter.recordEvent?.("xeno.usage.recorded",r)}}};export{R as AGENT_DAEMON_PROTOCOL_VERSION,X as AgentDaemonClient,Q as AgentDaemonServer,A as AgentEventStore,G as AgentRunController,D as AgentRunStore,re as MonitorManager,oe as MonitorStopTool,ne as MonitorTool,ae as OtelExporter,N as UsageAccumulator,ie as UsageLedger,w as WorkflowPlanner,Y as WorkflowRuntime,M as WorkflowStore,k as acquireControlPlaneLock,He as createAgentRunId,Ot as getAgentRunDir,bt as getAgentRunStoreDir};

package/dist/control-plane/metafile-cjs.json

@@ -0,0 +1 @@
+{"inputs":{"src/control-plane/types.ts":{"bytes":2467,"imports":[],"format":"esm"},"src/version.ts":{"bytes":38,"imports":[],"format":"esm"},"src/control-plane/lock.ts":{"bytes":2591,"imports":[{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/event-store.ts":{"bytes":2379,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"src/version.ts","kind":"import-statement","original":"../version.js"},{"path":"src/control-plane/lock.ts","kind":"import-statement","original":"./lock.js"}],"format":"esm"},"src/control-plane/run-store.ts":{"bytes":12025,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"src/version.ts","kind":"import-statement","original":"../version.js"},{"path":"src/control-plane/lock.ts","kind":"import-statement","original":"./lock.js"},{"path":"src/control-plane/event-store.ts","kind":"import-statement","original":"./event-store.js"}],"format":"esm"},"src/control-plane/controller.ts":{"bytes":4220,"imports":[{"path":"src/control-plane/run-store.ts","kind":"import-statement","original":"./run-store.js"}],"format":"esm"},"src/control-plane/daemon.ts":{"bytes":5047,"imports":[{"path":"node:crypto","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/workflow.ts":{"bytes":10410,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/monitor.ts":{"bytes":4128,"imports":[{"path":"node:crypto","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/usage.ts":{"bytes":5185,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/index.ts":{"bytes":281,"imports":[{"path":"src/control-plane/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/control-plane/run-store.ts","kind":"import-statement","original":"./run-store.js"},{"path":"src/control-plane/event-store.ts","kind":"import-statement","original":"./event-store.js"},{"path":"src/control-plane/controller.ts","kind":"import-statement","original":"./controller.js"},{"path":"src/control-plane/daemon.ts","kind":"import-statement","original":"./daemon.js"},{"path":"src/control-plane/workflow.ts","kind":"import-statement","original":"./workflow.js"},{"path":"src/control-plane/monitor.ts","kind":"import-statement","original":"./monitor.js"},{"path":"src/control-plane/usage.ts","kind":"import-statement","original":"./usage.js"},{"path":"src/control-plane/lock.ts","kind":"import-statement","original":"./lock.js"}],"format":"esm"}},"outputs":{"dist/control-plane/index.cjs":{"imports":[{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:fs","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:fs","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:fs","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:fs","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true},{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:crypto","kind":"require-call","external":true},{"path":"node:fs","kind":"require-call","external":true},{"path":"node:os","kind":"require-call","external":true},{"path":"node:path","kind":"require-call","external":true}],"exports":[],"entryPoint":"src/control-plane/index.ts","inputs":{"src/control-plane/index.ts":{"bytesInOutput":480},"src/control-plane/run-store.ts":{"bytesInOutput":5542},"src/version.ts":{"bytesInOutput":15},"src/control-plane/lock.ts":{"bytesInOutput":1063},"src/control-plane/event-store.ts":{"bytesInOutput":1057},"src/control-plane/controller.ts":{"bytesInOutput":1689},"src/control-plane/daemon.ts":{"bytesInOutput":1935},"src/control-plane/workflow.ts":{"bytesInOutput":4890},"src/control-plane/monitor.ts":{"bytesInOutput":1816},"src/control-plane/usage.ts":{"bytesInOutput":2271}},"bytes":21538}}}

package/dist/control-plane/metafile-esm.json

@@ -0,0 +1 @@
+{"inputs":{"src/control-plane/types.ts":{"bytes":2467,"imports":[],"format":"esm"},"src/version.ts":{"bytes":38,"imports":[],"format":"esm"},"src/control-plane/lock.ts":{"bytes":2591,"imports":[{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/event-store.ts":{"bytes":2379,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"src/version.ts","kind":"import-statement","original":"../version.js"},{"path":"src/control-plane/lock.ts","kind":"import-statement","original":"./lock.js"}],"format":"esm"},"src/control-plane/run-store.ts":{"bytes":12025,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"src/version.ts","kind":"import-statement","original":"../version.js"},{"path":"src/control-plane/lock.ts","kind":"import-statement","original":"./lock.js"},{"path":"src/control-plane/event-store.ts","kind":"import-statement","original":"./event-store.js"}],"format":"esm"},"src/control-plane/controller.ts":{"bytes":4220,"imports":[{"path":"src/control-plane/run-store.ts","kind":"import-statement","original":"./run-store.js"}],"format":"esm"},"src/control-plane/daemon.ts":{"bytes":5047,"imports":[{"path":"node:crypto","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/workflow.ts":{"bytes":10410,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/monitor.ts":{"bytes":4128,"imports":[{"path":"node:crypto","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/usage.ts":{"bytes":5185,"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"format":"esm"},"src/control-plane/index.ts":{"bytes":281,"imports":[{"path":"src/control-plane/types.ts","kind":"import-statement","original":"./types.js"},{"path":"src/control-plane/run-store.ts","kind":"import-statement","original":"./run-store.js"},{"path":"src/control-plane/event-store.ts","kind":"import-statement","original":"./event-store.js"},{"path":"src/control-plane/controller.ts","kind":"import-statement","original":"./controller.js"},{"path":"src/control-plane/daemon.ts","kind":"import-statement","original":"./daemon.js"},{"path":"src/control-plane/workflow.ts","kind":"import-statement","original":"./workflow.js"},{"path":"src/control-plane/monitor.ts","kind":"import-statement","original":"./monitor.js"},{"path":"src/control-plane/usage.ts","kind":"import-statement","original":"./usage.js"},{"path":"src/control-plane/lock.ts","kind":"import-statement","original":"./lock.js"}],"format":"esm"}},"outputs":{"dist/control-plane/index.js":{"imports":[{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true},{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:crypto","kind":"import-statement","external":true},{"path":"node:fs","kind":"import-statement","external":true},{"path":"node:os","kind":"import-statement","external":true},{"path":"node:path","kind":"import-statement","external":true}],"exports":["AGENT_DAEMON_PROTOCOL_VERSION","AgentDaemonClient","AgentDaemonServer","AgentEventStore","AgentRunController","AgentRunStore","MonitorManager","MonitorStopTool","MonitorTool","OtelExporter","UsageAccumulator","UsageLedger","WorkflowPlanner","WorkflowRuntime","WorkflowStore","acquireControlPlaneLock","createAgentRunId","getAgentRunDir","getAgentRunStoreDir"],"entryPoint":"src/control-plane/index.ts","inputs":{"src/control-plane/index.ts":{"bytesInOutput":0},"src/control-plane/run-store.ts":{"bytesInOutput":5373},"src/version.ts":{"bytesInOutput":15},"src/control-plane/lock.ts":{"bytesInOutput":1041},"src/control-plane/event-store.ts":{"bytesInOutput":1057},"src/control-plane/controller.ts":{"bytesInOutput":1686},"src/control-plane/daemon.ts":{"bytesInOutput":1941},"src/control-plane/workflow.ts":{"bytesInOutput":4760},"src/control-plane/monitor.ts":{"bytesInOutput":1820},"src/control-plane/usage.ts":{"bytesInOutput":2283}},"bytes":20410}}}

package/dist/control-room/index.cjs

@@ -0,0 +1 @@
+"use strict";var _=Object.defineProperty;var B=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var V=(t,n)=>{for(var r in n)_(t,r,{get:n[r],enumerable:!0})},z=(t,n,r,a)=>{if(n&&typeof n=="object"||typeof n=="function")for(let d of F(n))!P.call(t,d)&&d!==r&&_(t,d,{get:()=>n[d],enumerable:!(a=B(n,d))||a.enumerable});return t};var L=t=>z(_({},"__esModule",{value:!0}),t);var lt={};V(lt,{XENO_CONTROL_ROOM_SCHEMA_VERSION:()=>A,XenoControlRoomValidationError:()=>s,planXenoControlRoomAction:()=>Z,projectXenoControlRoom:()=>J,validateXenoControlRoomSnapshot:()=>M});module.exports=L(lt);var A="xeno.control-room.v1";var w=require("node:crypto");var G=6e4,s=class extends Error{constructor(n){super(n),this.name="XenoControlRoomValidationError"}};function J(t,n={}){let r=C(n.generatedAt??new Date().toISOString(),"generatedAt"),a=Date.parse(r),d=dt(n.staleAfterMs??G,1e3,864e5,"staleAfterMs");h(t.agents.map(o=>o.agentId),"agent"),h((t.tasks??[]).map(o=>o.taskId),"task"),h((t.approvals??[]).map(o=>o.approvalId),"approval"),h((t.artifacts??[]).map(o=>`${o.artifactId}:${o.revision}`),"artifact revision");let i=new Map(t.agents.map(o=>[o.agentId,Q(o)]));W(i);let g=new Map;for(let o of i.values())!o.parentAgentId||!i.has(o.parentAgentId)||g.set(o.parentAgentId,[...g.get(o.parentAgentId)??[],o.agentId]);let p=Y(i),e=[...i.values()].map(o=>{let c=tt(o.status),u=Date.parse(o.heartbeatAt??o.lastActivityAt??o.updatedAt),v=(c==="active"||c==="waiting"||c==="queued")&&Number.isFinite(u)&&a-u>d,U=Date.parse(o.createdAt);return{...o,statusCategory:c,depth:p(o.agentId),childAgentIds:(g.get(o.agentId)??[]).sort(),orphaned:!!(o.parentAgentId&&!i.has(o.parentAgentId)),stale:v,elapsedMs:Number.isFinite(U)?Math.max(0,a-U):0,allowedActions:ot(o,c),usage:at(o.usage)}}).sort(rt),l=new Set(e.map(o=>o.agentId)),m=(t.tasks??[]).map(o=>({...o,dependencyIds:[...new Set(o.dependencyIds??[])].sort(),artifactIds:[...new Set(o.artifactIds??[])].sort(),evidenceCount:ct(o.evidenceCount??0,"task evidenceCount"),orphanedOwner:!!(o.ownerAgentId&&!l.has(o.ownerAgentId)),blockedByTaskIds:(o.dependencyIds??[]).filter(c=>{let u=t.tasks?.find(v=>v.taskId===c);return!u||u.status!=="completed"}).sort()})).sort((o,c)=>o.taskId.localeCompare(c.taskId));q(m);let X=[...t.approvals??[]].sort((o,c)=>Date.parse(o.requestedAt)-Date.parse(c.requestedAt)),j=[...t.artifacts??[]].sort((o,c)=>o.artifactId.localeCompare(c.artifactId)||o.revision-c.revision),$=[...t.monitors??[]].sort((o,c)=>o.monitorId.localeCompare(c.monitorId)),b=[...t.goals??[]].sort((o,c)=>o.goalId.localeCompare(c.goalId)),y=[...t.notifications??[]].sort((o,c)=>Date.parse(o.createdAt)-Date.parse(c.createdAt)),D=et(e,m,X,b,y),H=e.reduce((o,c)=>st(o,c.usage),it()),K={agents:e.length,activeAgents:e.filter(o=>o.statusCategory==="active").length,waitingAgents:e.filter(o=>o.statusCategory==="waiting").length,blockedAgents:e.filter(o=>o.statusCategory==="blocked").length,terminalAgents:e.filter(o=>o.statusCategory==="terminal").length,staleAgents:e.filter(o=>o.stale).length,orphanedAgents:e.filter(o=>o.orphaned).length,tasks:m.length,completedTasks:m.filter(o=>o.status==="completed").length,blockedTasks:m.filter(o=>o.status==="blocked"||o.blockedByTaskIds.length>0).length,pendingApprovals:X.filter(o=>o.state==="pending").length,activeMonitors:$.filter(o=>o.status==="running").length,activeGoals:b.filter(o=>o.status==="active"||o.status==="blocked").length,unacknowledgedNotifications:y.filter(o=>!o.acknowledgedAt).length,usage:H},N={agents:e,rootAgentIds:e.filter(o=>!o.parentAgentId||!l.has(o.parentAgentId)).map(o=>o.agentId),tasks:m,approvals:X,artifacts:j,monitors:$,goals:b,notifications:y,attention:D,summary:K},E=R(x(N)),O={schemaVersion:A,snapshotId:n.snapshotId?.trim()||`control_room_${(0,w.randomUUID)()}`,generatedAt:r,staleAfterMs:d,sourceFingerprint:E,...N};return{...O,snapshotHash:R(x(O))}}function Z(t,n){if(M(t),n.snapshotHash!==t.snapshotHash)throw new s("Control-room action targets a stale snapshot");k(n.actionId,"actionId"),k(n.actorId,"actorId"),C(n.requestedAt,"requestedAt");let r=t.agents.find(l=>l.agentId===n.targetId||l.runId===n.targetId||l.sessionId===n.targetId),a=t.approvals.find(l=>l.approvalId===n.targetId),d=t.notifications.find(l=>l.notificationId===n.targetId),i,g=!1,p=n.scope?.trim()||"target",e={};if(n.kind==="jump"){if(!r&&!a&&!d)throw new s("Jump target is not present in the snapshot");i="read"}else if(n.kind==="steer"||n.kind==="follow_up"){if(!r||!r.allowedActions.includes(n.kind))throw new s(`${n.kind} is not available for this agent`);e.message=T(n.message,"message"),i="agent_message"}else if(n.kind==="stop"||n.kind==="retry"){if(!r||!r.allowedActions.includes(n.kind))throw new s(`${n.kind} is not available for this agent`);n.reason?.trim()&&(e.reason=n.reason.trim()),i="process_control",g=n.kind==="stop"}else if(n.kind==="approve"||n.kind==="reject"){if(!a||a.state!=="pending")throw new s("Approval target is not pending in this snapshot");if(n.reason?.trim()&&(e.reason=n.reason.trim()),n.kind==="reject"&&!e.reason)throw new s("A rejection reason is required");i="approval_decision",g=!0,p=n.scope?.trim()||a.scope}else if(n.kind==="acknowledge"){if(!d||d.acknowledgedAt)throw new s("Notification target is not awaiting acknowledgement");i="notification_ack"}else throw new s(`Unsupported control-room action: ${String(n.kind)}`);return{schemaVersion:"xeno.control-room-action.v1",actionId:n.actionId,kind:n.kind,targetId:n.targetId,actorId:n.actorId,requestedAt:n.requestedAt,expectedSnapshotHash:t.snapshotHash,idempotencyKey:R(`${t.snapshotHash}:${n.actionId}:${n.kind}:${n.targetId}`),authority:i,confirmationRequired:g,scope:p,payload:e}}function M(t){if(t.schemaVersion!==A)throw new s("Unsupported control-room schema");let{snapshotHash:n,...r}=t;if(R(x(r))!==t.snapshotHash)throw new s("Control-room snapshot hash mismatch");return t}function Q(t){if(k(t.agentId,"agentId"),T(t.workspaceId,"workspaceId"),T(t.name,"agent name"),C(t.createdAt,"agent createdAt"),C(t.updatedAt,"agent updatedAt"),t.parentAgentId===t.agentId)throw new s(`Agent ${t.agentId} cannot parent itself`);return{...t,taskIds:[...new Set(t.taskIds??[])].sort(),artifactIds:[...new Set(t.artifactIds??[])].sort()}}function W(t){for(let n of t.values()){let r=new Set,a=n;for(;a?.parentAgentId&&t.has(a.parentAgentId);){if(r.has(a.agentId))throw new s(`Agent hierarchy contains a cycle at ${a.agentId}`);r.add(a.agentId),a=t.get(a.parentAgentId)}}}function Y(t){let n=new Map;return function r(a){let d=n.get(a);if(d!==void 0)return d;let i=t.get(a)?.parentAgentId,g=i&&t.has(i)?r(i)+1:0;return n.set(a,g),g}}function q(t){let n=new Set(t.map(r=>r.taskId));for(let r of t){if(r.dependencyIds.includes(r.taskId))throw new s(`Task ${r.taskId} depends on itself`);for(let a of r.dependencyIds)if(!n.has(a))throw new s(`Task ${r.taskId} has unknown dependency ${a}`)}}function tt(t){return t==="queued"||t==="starting"?"queued":t==="running"||t==="working"||t==="idle"||t==="detached"?"active":t==="waiting_for_user"||t==="waiting_for_tool"||t==="waiting_for_hook"||t==="waiting_for_permission"||t==="paused"?"waiting":t==="blocked"?"blocked":"terminal"}function nt(t){return t==="active"||t==="waiting"||t==="blocked"||t==="queued"?["jump","steer","follow_up","stop"]:["jump","retry"]}function ot(t,n){let r=nt(n);if(t.allowedActions===void 0)return r;let a=[...new Set(t.allowedActions)];for(let d of a)if(!r.includes(d))throw new s(`Agent ${t.agentId} cannot advertise ${d} while ${n}`);return r.filter(d=>a.includes(d))}function et(t,n,r,a,d){let i=[],g=new Set(t.map(e=>e.agentId));for(let e of r.filter(l=>l.state==="pending"))i.push({attentionId:`attention:approval:${e.approvalId}`,kind:"approval",priority:"critical",targetId:e.approvalId,title:e.title,summary:e.summary??`${e.kind} approval requested for ${e.scope}`,createdAt:e.requestedAt,actions:["jump","approve","reject"]});for(let e of t)e.statusCategory==="blocked"?i.push(I(e,"blocked_agent","high",e.statusReason??"Agent is blocked")):e.statusCategory==="waiting"?i.push(I(e,"waiting_agent","high",e.statusReason??"Agent is waiting")):e.status==="failed"&&i.push(I(e,"failed_agent","high",e.statusReason??"Agent failed")),e.stale&&i.push(I(e,"stale_agent","high","Agent heartbeat is stale")),e.orphaned&&i.push(I(e,"orphaned_agent","normal",`Parent agent ${e.parentAgentId} is missing`));for(let e of n)(e.status==="blocked"||e.blockedByTaskIds.length)&&i.push({attentionId:`attention:task:${e.taskId}`,kind:"blocked_task",priority:"high",targetId:e.taskId,title:e.title,summary:e.blockedByTaskIds.length?`Blocked by ${e.blockedByTaskIds.join(", ")}`:"Task is blocked",createdAt:e.updatedAt,actions:["jump"]}),e.orphanedOwner&&i.push({attentionId:`attention:task-owner:${e.taskId}`,kind:"orphaned_task",priority:"normal",targetId:e.taskId,title:e.title,summary:`Assigned agent ${e.ownerAgentId} is missing`,createdAt:e.updatedAt,actions:["jump"]});for(let e of a.filter(l=>l.status==="blocked"))i.push({attentionId:`attention:goal:${e.goalId}`,kind:"blocked_goal",priority:"high",targetId:e.goalId,title:"Blocked goal",summary:e.nextAction??e.condition,createdAt:e.updatedAt,actions:["jump"]});for(let e of d.filter(l=>!l.acknowledgedAt&&l.targetAgentId&&!g.has(l.targetAgentId)))i.push({attentionId:`attention:notification:${e.notificationId}`,kind:"orphaned_notification",priority:"normal",targetId:e.notificationId,title:"Orphaned notification",summary:e.summary,createdAt:e.createdAt,actions:["jump","acknowledge"]});let p={critical:0,high:1,normal:2};return i.sort((e,l)=>p[e.priority]-p[l.priority]||Date.parse(e.createdAt)-Date.parse(l.createdAt))}function I(t,n,r,a){return{attentionId:`attention:${n}:${t.agentId}`,kind:n,priority:r,targetId:t.agentId,title:t.title??t.name,summary:a,createdAt:t.lastActivityAt??t.updatedAt,actions:t.allowedActions}}function rt(t,n){return t.depth-n.depth||t.agentId.localeCompare(n.agentId)}function at(t){let n=f(t?.inputTokens),r=f(t?.outputTokens);return{inputTokens:n,outputTokens:r,totalTokens:f(t?.totalTokens??n+r),...t?.cachedInputTokens!==void 0?{cachedInputTokens:f(t.cachedInputTokens)}:{},...t?.estimatedCostUsd!==void 0?{estimatedCostUsd:f(t.estimatedCostUsd)}:{}}}function it(){return{inputTokens:0,outputTokens:0,totalTokens:0,cachedInputTokens:0,estimatedCostUsd:0}}function st(t,n){return{inputTokens:t.inputTokens+n.inputTokens,outputTokens:t.outputTokens+n.outputTokens,totalTokens:t.totalTokens+n.totalTokens,cachedInputTokens:(t.cachedInputTokens??0)+(n.cachedInputTokens??0),estimatedCostUsd:(t.estimatedCostUsd??0)+(n.estimatedCostUsd??0)}}function h(t,n){let r=new Set;for(let a of t){if(k(a,`${n} ID`),r.has(a))throw new s(`Duplicate ${n} ID: ${a}`);r.add(a)}}function k(t,n){let r=t?.trim()??"";if(!/^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/u.test(r))throw new s(`${n} is invalid`);return r}function T(t,n){let r=t?.trim()??"";if(!r||r.length>64*1024)throw new s(`${n} is required`);return r}function C(t,n){if(!Number.isFinite(Date.parse(t)))throw new s(`${n} must be a valid timestamp`);return t}function dt(t,n,r,a){if(!Number.isInteger(t)||t<n||t>r)throw new s(`${a} must be between ${n} and ${r}`);return t}function ct(t,n){if(!Number.isInteger(t)||t<0)throw new s(`${n} must be a non-negative integer`);return t}function f(t){return Number.isFinite(t)?Math.max(0,t??0):0}function R(t){return(0,w.createHash)("sha256").update(t,"utf8").digest("hex")}function x(t){return JSON.stringify(S(t))}function S(t){return Array.isArray(t)?t.map(S):!t||typeof t!="object"?t:Object.fromEntries(Object.entries(t).filter(([,n])=>n!==void 0).sort(([n],[r])=>n.localeCompare(r)).map(([n,r])=>[n,S(r)]))}0&&(module.exports={XENO_CONTROL_ROOM_SCHEMA_VERSION,XenoControlRoomValidationError,planXenoControlRoomAction,projectXenoControlRoom,validateXenoControlRoomSnapshot});