@clawrent/protocol 0.1.0

package/dist/envelope.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+export declare const SenderSchema: z.ZodObject<{
+    role: z.ZodEnum<["provider", "consumer", "platform", "staff"]>;
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: "provider" | "consumer" | "platform" | "staff";
+    agentId: string;
+}, {
+    role: "provider" | "consumer" | "platform" | "staff";
+    agentId: string;
+}>;
+export declare const ClawRentMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    timestamp: z.ZodNumber;
+    sender: z.ZodObject<{
+        role: z.ZodEnum<["provider", "consumer", "platform", "staff"]>;
+        agentId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        role: "provider" | "consumer" | "platform" | "staff";
+        agentId: string;
+    }, {
+        role: "provider" | "consumer" | "platform" | "staff";
+        agentId: string;
+    }>;
+    type: z.ZodEnum<[string, ...string[]]>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    signature: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    id: string;
+    sessionId: string;
+    timestamp: number;
+    sender: {
+        role: "provider" | "consumer" | "platform" | "staff";
+        agentId: string;
+    };
+    payload: Record<string, unknown>;
+    signature?: string | undefined;
+}, {
+    type: string;
+    id: string;
+    sessionId: string;
+    timestamp: number;
+    sender: {
+        role: "provider" | "consumer" | "platform" | "staff";
+        agentId: string;
+    };
+    payload: Record<string, unknown>;
+    signature?: string | undefined;
+}>;
+export type ClawRentMessage = z.infer<typeof ClawRentMessageSchema>;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,YAAY;;;;;;;;;EAGvB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/envelope.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { MessageType } from './message-types.js';
+const allMessageTypes = Object.values(MessageType);
+export const SenderSchema = z.object({
+    role: z.enum(['provider', 'consumer', 'platform', 'staff']),
+    agentId: z.string(),
+});
+export const ClawRentMessageSchema = z.object({
+    id: z.string(),
+    sessionId: z.string(),
+    timestamp: z.number(),
+    sender: SenderSchema,
+    type: z.enum(allMessageTypes),
+    payload: z.record(z.unknown()),
+    signature: z.string().optional(),
+});
+//# sourceMappingURL=envelope.js.map

package/dist/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../src/envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAEnD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAwC,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,7 @@
+import type { ClawRentMessage } from './envelope.js';
+import type { MessageType } from './message-types.js';
+export declare function createMessage(sessionId: string, sender: {
+    role: 'provider' | 'consumer' | 'platform' | 'staff';
+    agentId: string;
+}, type: MessageType, payload: Record<string, unknown>): ClawRentMessage;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAWtD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACjF,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,eAAe,CASjB"}

package/dist/factory.js

@@ -0,0 +1,18 @@
+let idCounter = 0;
+function generateMessageId() {
+    const timestamp = Date.now().toString(36);
+    const counter = (idCounter++).toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `msg_${timestamp}_${counter}_${random}`;
+}
+export function createMessage(sessionId, sender, type, payload) {
+    return {
+        id: generateMessageId(),
+        sessionId,
+        timestamp: Date.now(),
+        sender,
+        type,
+        payload,
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAGA,IAAI,SAAS,GAAG,CAAC,CAAC;AAElB,SAAS,iBAAiB;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,OAAO,SAAS,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,SAAiB,EACjB,MAAiF,EACjF,IAAiB,EACjB,OAAgC;IAEhC,OAAO;QACL,EAAE,EAAE,iBAAiB,EAAE;QACvB,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,MAAM;QACN,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { MessageType } from './message-types.js';
+export { ClawRentMessageSchema, type ClawRentMessage } from './envelope.js';
+export { ExecInstructionSchema, type ExecInstruction } from './instructions/exec.js';
+export { ReadFileInstructionSchema, type ReadFileInstruction } from './instructions/read-file.js';
+export { WriteFileInstructionSchema, type WriteFileInstruction } from './instructions/write-file.js';
+export { ReadDirInstructionSchema, type ReadDirInstruction } from './instructions/read-dir.js';
+export { BatchInstructionSchema, type BatchInstruction } from './instructions/batch.js';
+export { SuccessResultSchema, type SuccessResult } from './results/success.js';
+export { ErrorResultSchema, type ErrorResult } from './results/error.js';
+export { PermissionDeniedResultSchema, type PermissionDeniedResult } from './results/permission-denied.js';
+export { SessionControlSchema, type SessionControl } from './session/control.js';
+export { DialogueMessageSchema, type DialogueMessage } from './session/dialogue.js';
+export { validateMessage } from './validators.js';
+export { createMessage } from './factory.js';
+export { StaffTaskAssignSchema, type StaffTaskAssign, StaffTaskResultSchema, type StaffTaskResult, StaffQuerySchema, type StaffQuery, StaffQueryResponseSchema, type StaffQueryResponse, StaffActionProposalSchema, type StaffActionProposal, StaffActionOutcomeSchema, type StaffActionOutcome, } from './staff/messages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACrG,OAAO,EAAE,wBAAwB,EAAE,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,qBAAqB,EACrB,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,UAAU,EACf,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,yBAAyB,EACzB,KAAK,mBAAmB,EACxB,wBAAwB,EACxB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export { MessageType } from './message-types.js';
+export { ClawRentMessageSchema } from './envelope.js';
+export { ExecInstructionSchema } from './instructions/exec.js';
+export { ReadFileInstructionSchema } from './instructions/read-file.js';
+export { WriteFileInstructionSchema } from './instructions/write-file.js';
+export { ReadDirInstructionSchema } from './instructions/read-dir.js';
+export { BatchInstructionSchema } from './instructions/batch.js';
+export { SuccessResultSchema } from './results/success.js';
+export { ErrorResultSchema } from './results/error.js';
+export { PermissionDeniedResultSchema } from './results/permission-denied.js';
+export { SessionControlSchema } from './session/control.js';
+export { DialogueMessageSchema } from './session/dialogue.js';
+export { validateMessage } from './validators.js';
+export { createMessage } from './factory.js';
+export { StaffTaskAssignSchema, StaffTaskResultSchema, StaffQuerySchema, StaffQueryResponseSchema, StaffActionProposalSchema, StaffActionOutcomeSchema, } from './staff/messages.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAwB,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAA4B,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAA6B,MAAM,8BAA8B,CAAC;AACrG,OAAO,EAAE,wBAAwB,EAA2B,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAyB,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAA+B,MAAM,gCAAgC,CAAC;AAC3G,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAwB,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,qBAAqB,EAErB,qBAAqB,EAErB,gBAAgB,EAEhB,wBAAwB,EAExB,yBAAyB,EAEzB,wBAAwB,GAEzB,MAAM,qBAAqB,CAAC"}

package/dist/instructions/batch.d.ts

@@ -0,0 +1,334 @@
+import { z } from 'zod';
+export declare const BatchInstructionSchema: z.ZodObject<{
+    instructions: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"instruction.exec">;
+        payload: z.ZodObject<{
+            command: z.ZodString;
+            workingDir: z.ZodOptional<z.ZodString>;
+            timeout: z.ZodDefault<z.ZodNumber>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            expect: z.ZodOptional<z.ZodObject<{
+                exitCode: z.ZodOptional<z.ZodNumber>;
+                stdoutContains: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            }, {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            }>>;
+            onFailure: z.ZodDefault<z.ZodEnum<["abort", "continue", "retry"]>>;
+            explanation: z.ZodOptional<z.ZodString>;
+            riskLevel: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+        }, "strip", z.ZodTypeAny, {
+            command: string;
+            timeout: number;
+            onFailure: "abort" | "continue" | "retry";
+            riskLevel: "low" | "medium" | "high";
+            workingDir?: string | undefined;
+            env?: Record<string, string> | undefined;
+            expect?: {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            } | undefined;
+            explanation?: string | undefined;
+        }, {
+            command: string;
+            workingDir?: string | undefined;
+            timeout?: number | undefined;
+            env?: Record<string, string> | undefined;
+            expect?: {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            } | undefined;
+            onFailure?: "abort" | "continue" | "retry" | undefined;
+            explanation?: string | undefined;
+            riskLevel?: "low" | "medium" | "high" | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "instruction.exec";
+        payload: {
+            command: string;
+            timeout: number;
+            onFailure: "abort" | "continue" | "retry";
+            riskLevel: "low" | "medium" | "high";
+            workingDir?: string | undefined;
+            env?: Record<string, string> | undefined;
+            expect?: {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            } | undefined;
+            explanation?: string | undefined;
+        };
+    }, {
+        type: "instruction.exec";
+        payload: {
+            command: string;
+            workingDir?: string | undefined;
+            timeout?: number | undefined;
+            env?: Record<string, string> | undefined;
+            expect?: {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            } | undefined;
+            onFailure?: "abort" | "continue" | "retry" | undefined;
+            explanation?: string | undefined;
+            riskLevel?: "low" | "medium" | "high" | undefined;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"instruction.read_file">;
+        payload: z.ZodObject<{
+            path: z.ZodString;
+            encoding: z.ZodDefault<z.ZodString>;
+            lineRange: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                start: number;
+                end: number;
+            }, {
+                start: number;
+                end: number;
+            }>>;
+            purpose: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            encoding: string;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            purpose?: string | undefined;
+        }, {
+            path: string;
+            encoding?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            purpose?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "instruction.read_file";
+        payload: {
+            path: string;
+            encoding: string;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            purpose?: string | undefined;
+        };
+    }, {
+        type: "instruction.read_file";
+        payload: {
+            path: string;
+            encoding?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            purpose?: string | undefined;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"instruction.write_file">;
+        payload: z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodOptional<z.ZodString>;
+            patch: z.ZodOptional<z.ZodObject<{
+                type: z.ZodEnum<["line_replace", "append", "prepend", "regex_replace"]>;
+                target: z.ZodOptional<z.ZodString>;
+                replacement: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            }, {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            }>>;
+            createDirs: z.ZodDefault<z.ZodBoolean>;
+            backup: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            createDirs: boolean;
+            backup: boolean;
+            content?: string | undefined;
+            patch?: {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            } | undefined;
+        }, {
+            path: string;
+            content?: string | undefined;
+            patch?: {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            } | undefined;
+            createDirs?: boolean | undefined;
+            backup?: boolean | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "instruction.write_file";
+        payload: {
+            path: string;
+            createDirs: boolean;
+            backup: boolean;
+            content?: string | undefined;
+            patch?: {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            } | undefined;
+        };
+    }, {
+        type: "instruction.write_file";
+        payload: {
+            path: string;
+            content?: string | undefined;
+            patch?: {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            } | undefined;
+            createDirs?: boolean | undefined;
+            backup?: boolean | undefined;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"instruction.read_dir">;
+        payload: z.ZodObject<{
+            path: z.ZodString;
+            recursive: z.ZodDefault<z.ZodBoolean>;
+            pattern: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            recursive: boolean;
+            pattern?: string | undefined;
+        }, {
+            path: string;
+            recursive?: boolean | undefined;
+            pattern?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "instruction.read_dir";
+        payload: {
+            path: string;
+            recursive: boolean;
+            pattern?: string | undefined;
+        };
+    }, {
+        type: "instruction.read_dir";
+        payload: {
+            path: string;
+            recursive?: boolean | undefined;
+            pattern?: string | undefined;
+        };
+    }>]>, "many">;
+    execution: z.ZodDefault<z.ZodEnum<["parallel", "sequential"]>>;
+    stopOnError: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    instructions: ({
+        type: "instruction.exec";
+        payload: {
+            command: string;
+            timeout: number;
+            onFailure: "abort" | "continue" | "retry";
+            riskLevel: "low" | "medium" | "high";
+            workingDir?: string | undefined;
+            env?: Record<string, string> | undefined;
+            expect?: {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            } | undefined;
+            explanation?: string | undefined;
+        };
+    } | {
+        type: "instruction.read_file";
+        payload: {
+            path: string;
+            encoding: string;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            purpose?: string | undefined;
+        };
+    } | {
+        type: "instruction.write_file";
+        payload: {
+            path: string;
+            createDirs: boolean;
+            backup: boolean;
+            content?: string | undefined;
+            patch?: {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            } | undefined;
+        };
+    } | {
+        type: "instruction.read_dir";
+        payload: {
+            path: string;
+            recursive: boolean;
+            pattern?: string | undefined;
+        };
+    })[];
+    execution: "parallel" | "sequential";
+    stopOnError: boolean;
+}, {
+    instructions: ({
+        type: "instruction.exec";
+        payload: {
+            command: string;
+            workingDir?: string | undefined;
+            timeout?: number | undefined;
+            env?: Record<string, string> | undefined;
+            expect?: {
+                exitCode?: number | undefined;
+                stdoutContains?: string | undefined;
+            } | undefined;
+            onFailure?: "abort" | "continue" | "retry" | undefined;
+            explanation?: string | undefined;
+            riskLevel?: "low" | "medium" | "high" | undefined;
+        };
+    } | {
+        type: "instruction.read_file";
+        payload: {
+            path: string;
+            encoding?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            purpose?: string | undefined;
+        };
+    } | {
+        type: "instruction.write_file";
+        payload: {
+            path: string;
+            content?: string | undefined;
+            patch?: {
+                type: "line_replace" | "append" | "prepend" | "regex_replace";
+                target?: string | undefined;
+                replacement?: string | undefined;
+            } | undefined;
+            createDirs?: boolean | undefined;
+            backup?: boolean | undefined;
+        };
+    } | {
+        type: "instruction.read_dir";
+        payload: {
+            path: string;
+            recursive?: boolean | undefined;
+            pattern?: string | undefined;
+        };
+    })[];
+    execution?: "parallel" | "sequential" | undefined;
+    stopOnError?: boolean | undefined;
+}>;
+export type BatchInstruction = z.infer<typeof BatchInstructionSchema>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/instructions/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/instructions/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/instructions/batch.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { ExecInstructionSchema } from './exec.js';
+import { ReadFileInstructionSchema } from './read-file.js';
+import { WriteFileInstructionSchema } from './write-file.js';
+import { ReadDirInstructionSchema } from './read-dir.js';
+const SingleInstructionSchema = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('instruction.exec'), payload: ExecInstructionSchema }),
+    z.object({ type: z.literal('instruction.read_file'), payload: ReadFileInstructionSchema }),
+    z.object({ type: z.literal('instruction.write_file'), payload: WriteFileInstructionSchema }),
+    z.object({ type: z.literal('instruction.read_dir'), payload: ReadDirInstructionSchema }),
+]);
+export const BatchInstructionSchema = z.object({
+    instructions: z.array(SingleInstructionSchema).min(1).max(50),
+    execution: z.enum(['parallel', 'sequential']).default('sequential'),
+    stopOnError: z.boolean().default(true),
+});
+//# sourceMappingURL=batch.js.map

package/dist/instructions/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/instructions/batch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3D,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjF,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;IAC1F,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;IAC5F,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7D,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACvC,CAAC,CAAC"}

package/dist/instructions/exec.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export declare const ExecInstructionSchema: z.ZodObject<{
+    command: z.ZodString;
+    workingDir: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    expect: z.ZodOptional<z.ZodObject<{
+        exitCode: z.ZodOptional<z.ZodNumber>;
+        stdoutContains: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        exitCode?: number | undefined;
+        stdoutContains?: string | undefined;
+    }, {
+        exitCode?: number | undefined;
+        stdoutContains?: string | undefined;
+    }>>;
+    onFailure: z.ZodDefault<z.ZodEnum<["abort", "continue", "retry"]>>;
+    explanation: z.ZodOptional<z.ZodString>;
+    riskLevel: z.ZodDefault<z.ZodEnum<["low", "medium", "high"]>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeout: number;
+    onFailure: "abort" | "continue" | "retry";
+    riskLevel: "low" | "medium" | "high";
+    workingDir?: string | undefined;
+    env?: Record<string, string> | undefined;
+    expect?: {
+        exitCode?: number | undefined;
+        stdoutContains?: string | undefined;
+    } | undefined;
+    explanation?: string | undefined;
+}, {
+    command: string;
+    workingDir?: string | undefined;
+    timeout?: number | undefined;
+    env?: Record<string, string> | undefined;
+    expect?: {
+        exitCode?: number | undefined;
+        stdoutContains?: string | undefined;
+    } | undefined;
+    onFailure?: "abort" | "continue" | "retry" | undefined;
+    explanation?: string | undefined;
+    riskLevel?: "low" | "medium" | "high" | undefined;
+}>;
+export type ExecInstruction = z.infer<typeof ExecInstructionSchema>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/instructions/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/instructions/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAchC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/instructions/exec.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const ExecInstructionSchema = z.object({
+    command: z.string().min(1),
+    workingDir: z.string().optional(),
+    timeout: z.number().positive().default(30000),
+    env: z.record(z.string()).optional(),
+    expect: z
+        .object({
+        exitCode: z.number().optional(),
+        stdoutContains: z.string().optional(),
+    })
+        .optional(),
+    onFailure: z.enum(['abort', 'continue', 'retry']).default('abort'),
+    explanation: z.string().optional(),
+    riskLevel: z.enum(['low', 'medium', 'high']).default('medium'),
+});
+//# sourceMappingURL=exec.js.map

package/dist/instructions/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/instructions/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CAC/D,CAAC,CAAC"}

package/dist/instructions/read-dir.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export declare const ReadDirInstructionSchema: z.ZodObject<{
+    path: z.ZodString;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    pattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+    pattern?: string | undefined;
+}, {
+    path: string;
+    recursive?: boolean | undefined;
+    pattern?: string | undefined;
+}>;
+export type ReadDirInstruction = z.infer<typeof ReadDirInstructionSchema>;
+//# sourceMappingURL=read-dir.d.ts.map

package/dist/instructions/read-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-dir.d.ts","sourceRoot":"","sources":["../../src/instructions/read-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/instructions/read-dir.js

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const ReadDirInstructionSchema = z.object({
+    path: z.string().min(1),
+    recursive: z.boolean().default(false),
+    pattern: z.string().optional(),
+});
+//# sourceMappingURL=read-dir.js.map

package/dist/instructions/read-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-dir.js","sourceRoot":"","sources":["../../src/instructions/read-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC"}