File size: 2,433 Bytes
fcd8223 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 | /** Shared node-host request, result, event, and approval-bin provider contracts. */
import type { SkillBinTrustEntry, SystemRunApprovalPlan } from "../infra/exec-approvals.js";
/**
* Shared request/result/event types for node-host command execution.
*
* These contracts are consumed by Gateway invoke handling, approval planning,
* and node-host event emission.
*/
/** Gateway invoke frame delivered to node-host command handlers. */
export type NodeInvokeRequestPayload = {
id: string;
nodeId: string;
command: string;
paramsJSON?: string | null;
timeoutMs?: number | null;
idempotencyKey?: string | null;
sessionKey?: string | null;
};
/** Input payload for a node-host system.run invocation. */
export type SystemRunParams = {
command: string[];
rawCommand?: string | null;
systemRunPlan?: SystemRunApprovalPlan | null;
cwd?: string | null;
env?: Record<string, string>;
timeoutMs?: number | null;
needsScreenRecording?: boolean | null;
agentId?: string | null;
sessionKey?: string | null;
approved?: boolean | null;
approvalDecision?: string | null;
approvalSource?: string | null;
runId?: string | null;
suppressNotifyOnExit?: boolean | null;
};
/** Captured process result returned by system.run execution. */
export type RunResult = {
exitCode?: number;
timedOut: boolean;
noOutputTimedOut?: boolean;
success: boolean;
stdout: string;
stderr: string;
error?: string | null;
truncated: boolean;
};
/** Gateway event payload emitted for exec lifecycle notifications. */
export type ExecEventPayload = {
sessionKey: string;
runId: string;
host: string;
command?: string;
exitCode?: number;
timedOut?: boolean;
success?: boolean;
output?: string;
reason?: string;
suppressNotifyOnExit?: boolean;
};
/** Normalized exec result fields used when building finished events. */
export type ExecFinishedResult = {
stdout?: string;
stderr?: string;
error?: string | null;
exitCode?: number | null;
timedOut?: boolean;
success?: boolean;
};
/** Inputs required to emit an exec finished event. */
export type ExecFinishedEventParams = {
sessionKey: string;
runId: string;
commandText: string;
result: ExecFinishedResult;
suppressNotifyOnExit?: boolean;
};
/** Provider for trusted skill-bin entries used during approval checks. */
export type SkillBinsProvider = {
current(force?: boolean): Promise<SkillBinTrustEntry[]>;
};
|