@matthias-hausberger/beige 0.0.1

package/dist/skills/registry.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.spec.d.ts","sourceRoot":"","sources":["../../src/skills/registry.spec.ts"],"names":[],"mappings":""}

package/dist/skills/registry.spec.js

@@ -0,0 +1,220 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { writeFileSync, mkdirSync, rmSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+import { loadSkillManifest, loadSkills, buildSkillContext, validateSkillDeps, } from "./registry.js";
+describe("skills/registry", () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = join(tmpdir(), `beige-skill-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        mkdirSync(tempDir, { recursive: true });
+    });
+    afterEach(() => {
+        try {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    describe("loadSkillManifest", () => {
+        it("loads a valid skill manifest", () => {
+            const skillDir = join(tempDir, "test-skill");
+            mkdirSync(skillDir);
+            writeFileSync(join(skillDir, "skill.json"), JSON.stringify({
+                name: "test-skill",
+                description: "A test skill",
+            }));
+            const manifest = loadSkillManifest(skillDir);
+            expect(manifest.name).toBe("test-skill");
+            expect(manifest.description).toBe("A test skill");
+        });
+        it("loads manifest with optional fields", () => {
+            const skillDir = join(tempDir, "test-skill");
+            mkdirSync(skillDir);
+            writeFileSync(join(skillDir, "skill.json"), JSON.stringify({
+                name: "test-skill",
+                description: "A test skill",
+                contextFile: "GUIDE.md",
+                requires: {
+                    tools: ["git"],
+                    skills: ["basics"],
+                },
+            }));
+            const manifest = loadSkillManifest(skillDir);
+            expect(manifest.contextFile).toBe("GUIDE.md");
+            expect(manifest.requires?.tools).toEqual(["git"]);
+            expect(manifest.requires?.skills).toEqual(["basics"]);
+        });
+        it("throws when skill.json is missing", () => {
+            const skillDir = join(tempDir, "missing-manifest");
+            mkdirSync(skillDir);
+            expect(() => loadSkillManifest(skillDir)).toThrow("Skill manifest not found");
+        });
+        it("throws when skill.json has invalid JSON", () => {
+            const skillDir = join(tempDir, "invalid-json");
+            mkdirSync(skillDir);
+            writeFileSync(join(skillDir, "skill.json"), "not valid json {");
+            expect(() => loadSkillManifest(skillDir)).toThrow("Invalid JSON in skill manifest");
+        });
+        it("throws when name is missing", () => {
+            const skillDir = join(tempDir, "missing-name");
+            mkdirSync(skillDir);
+            writeFileSync(join(skillDir, "skill.json"), JSON.stringify({
+                description: "A test skill",
+            }));
+            expect(() => loadSkillManifest(skillDir)).toThrow("requires 'name' and 'description'");
+        });
+        it("throws when description is missing", () => {
+            const skillDir = join(tempDir, "missing-desc");
+            mkdirSync(skillDir);
+            writeFileSync(join(skillDir, "skill.json"), JSON.stringify({
+                name: "test-skill",
+            }));
+            expect(() => loadSkillManifest(skillDir)).toThrow("requires 'name' and 'description'");
+        });
+    });
+    describe("loadSkills", () => {
+        it("returns empty map when no skills in config", async () => {
+            const config = {
+                llm: { providers: {} },
+                tools: {},
+                agents: {},
+                channels: {},
+            };
+            const skills = await loadSkills(config);
+            expect(skills.size).toBe(0);
+        });
+        it("loads multiple skills from config", async () => {
+            // Create skill directories
+            const skill1Dir = join(tempDir, "skill1");
+            const skill2Dir = join(tempDir, "skill2");
+            mkdirSync(skill1Dir);
+            mkdirSync(skill2Dir);
+            writeFileSync(join(skill1Dir, "skill.json"), JSON.stringify({
+                name: "skill1",
+                description: "First skill",
+            }));
+            writeFileSync(join(skill2Dir, "skill.json"), JSON.stringify({
+                name: "skill2",
+                description: "Second skill",
+                requires: { tools: ["git"] },
+            }));
+            const config = {
+                llm: { providers: {} },
+                tools: {},
+                agents: {},
+                channels: {},
+                skills: {
+                    "my-skill1": { path: skill1Dir },
+                    "my-skill2": { path: skill2Dir },
+                },
+            };
+            const skills = await loadSkills(config);
+            expect(skills.size).toBe(2);
+            expect(skills.get("my-skill1")?.manifest.description).toBe("First skill");
+            expect(skills.get("my-skill2")?.manifest.requires?.tools).toEqual(["git"]);
+        });
+    });
+    describe("buildSkillContext", () => {
+        function createLoadedSkill(name, description) {
+            return {
+                name,
+                path: `/skills/${name}`,
+                manifest: {
+                    name,
+                    description,
+                },
+            };
+        }
+        it("returns empty string for empty skill list", () => {
+            const context = buildSkillContext([], new Map());
+            expect(context).toBe("");
+        });
+        it("builds context for single skill", () => {
+            const skills = new Map([
+                ["review", createLoadedSkill("review", "Code review guidelines")],
+            ]);
+            const context = buildSkillContext(["review"], skills);
+            expect(context).toContain("## Available Skills");
+            expect(context).toContain("### review");
+            expect(context).toContain("Code review guidelines");
+            expect(context).toContain("/skills/review/");
+        });
+        it("builds context for multiple skills", () => {
+            const skills = new Map([
+                ["review", createLoadedSkill("review", "Code review guidelines")],
+                ["testing", createLoadedSkill("testing", "Testing best practices")],
+            ]);
+            const context = buildSkillContext(["review", "testing"], skills);
+            expect(context).toContain("### review");
+            expect(context).toContain("### testing");
+            expect(context).toContain("Code review guidelines");
+            expect(context).toContain("Testing best practices");
+        });
+        it("skips skills not in loaded map", () => {
+            const skills = new Map([
+                ["review", createLoadedSkill("review", "Code review guidelines")],
+            ]);
+            const context = buildSkillContext(["review", "missing"], skills);
+            expect(context).toContain("### review");
+            expect(context).not.toContain("### missing");
+        });
+    });
+    describe("validateSkillDeps", () => {
+        function createSkillWithDeps(name, requires) {
+            return {
+                name,
+                path: `/skills/${name}`,
+                manifest: {
+                    name,
+                    description: `${name} skill`,
+                    requires,
+                },
+            };
+        }
+        it("passes when no dependencies required", () => {
+            const skills = new Map([
+                ["skill1", createSkillWithDeps("skill1")],
+            ]);
+            expect(() => validateSkillDeps(["skill1"], [], skills)).not.toThrow();
+        });
+        it("passes when tool dependencies are satisfied", () => {
+            const skills = new Map([
+                ["skill1", createSkillWithDeps("skill1", { tools: ["git", "exec"] })],
+            ]);
+            expect(() => validateSkillDeps(["skill1"], ["git", "exec"], skills)).not.toThrow();
+        });
+        it("passes when skill dependencies are satisfied", () => {
+            const skills = new Map([
+                ["basics", createSkillWithDeps("basics")],
+                ["advanced", createSkillWithDeps("advanced", { skills: ["basics"] })],
+            ]);
+            expect(() => validateSkillDeps(["basics", "advanced"], [], skills)).not.toThrow();
+        });
+        it("throws when required tool is missing", () => {
+            const skills = new Map([
+                ["skill1", createSkillWithDeps("skill1", { tools: ["git"] })],
+            ]);
+            expect(() => validateSkillDeps(["skill1"], [], skills)).toThrow("Skill 'skill1' requires tool 'git' but it's not available to this agent");
+        });
+        it("throws when required skill is missing", () => {
+            const skills = new Map([
+                ["advanced", createSkillWithDeps("advanced", { skills: ["basics"] })],
+            ]);
+            expect(() => validateSkillDeps(["advanced"], [], skills)).toThrow("Skill 'advanced' requires skill 'basics' but it's not available to this agent");
+        });
+        it("validates multiple dependencies", () => {
+            const skills = new Map([
+                ["skill1", createSkillWithDeps("skill1", {
+                        tools: ["git", "kv"],
+                        skills: ["basics"],
+                    })],
+                ["basics", createSkillWithDeps("basics")],
+            ]);
+            // Missing 'kv' tool
+            expect(() => validateSkillDeps(["skill1", "basics"], ["git"], skills)).toThrow("Skill 'skill1' requires tool 'kv' but it's not available to this agent");
+        });
+    });
+});
+//# sourceMappingURL=registry.spec.js.map

package/dist/skills/registry.spec.js.map

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

package/dist/socket/protocol.d.ts

@@ -0,0 +1,21 @@
+import type { SessionContext } from "../types/session.js";
+/**
+ * Socket protocol between sandbox tool launchers and the gateway.
+ * Messages are newline-delimited JSON over Unix domain socket.
+ */
+export interface ToolRequest {
+    type: "tool_request";
+    tool: string;
+    args: string[];
+    sessionContext?: SessionContext;
+}
+export interface ToolResponse {
+    type: "tool_response";
+    success: boolean;
+    output?: string;
+    error?: string;
+    exitCode: number;
+}
+export declare function encodeMessage(msg: ToolRequest | ToolResponse): Buffer;
+export declare function decodeMessage(data: string): ToolRequest | ToolResponse;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/socket/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/socket/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,GAAG,MAAM,CAErE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,CAEtE"}

package/dist/socket/protocol.js

@@ -0,0 +1,7 @@
+export function encodeMessage(msg) {
+    return Buffer.from(JSON.stringify(msg) + "\n");
+}
+export function decodeMessage(data) {
+    return JSON.parse(data.trim());
+}
+//# sourceMappingURL=protocol.js.map

package/dist/socket/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/socket/protocol.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,aAAa,CAAC,GAA+B;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/socket/protocol.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=protocol.spec.d.ts.map

package/dist/socket/protocol.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.spec.d.ts","sourceRoot":"","sources":["../../src/socket/protocol.spec.ts"],"names":[],"mappings":""}

package/dist/socket/protocol.spec.js

@@ -0,0 +1,135 @@
+import { describe, it, expect } from "vitest";
+import { encodeMessage, decodeMessage, } from "./protocol.js";
+describe("protocol", () => {
+    describe("encodeMessage", () => {
+        it("encodes ToolRequest with newline suffix", () => {
+            const msg = {
+                type: "tool_request",
+                tool: "kv",
+                args: ["set", "mykey", "myvalue"],
+            };
+            const encoded = encodeMessage(msg);
+            expect(encoded.toString()).toBe(JSON.stringify(msg) + "\n");
+        });
+        it("encodes successful ToolResponse", () => {
+            const msg = {
+                type: "tool_response",
+                success: true,
+                output: "OK",
+                exitCode: 0,
+            };
+            const encoded = encodeMessage(msg);
+            expect(encoded.toString()).toBe(JSON.stringify(msg) + "\n");
+        });
+        it("encodes error ToolResponse", () => {
+            const msg = {
+                type: "tool_response",
+                success: false,
+                error: "Permission denied",
+                exitCode: 1,
+            };
+            const encoded = encodeMessage(msg);
+            expect(encoded.toString()).toBe(JSON.stringify(msg) + "\n");
+        });
+        it("encodes ToolResponse with all fields", () => {
+            const msg = {
+                type: "tool_response",
+                success: true,
+                output: "result data",
+                error: undefined,
+                exitCode: 0,
+            };
+            const encoded = encodeMessage(msg);
+            expect(encoded.toString()).toContain("tool_response");
+            expect(encoded.toString()).toContain("result data");
+        });
+        it("returns a Buffer", () => {
+            const msg = {
+                type: "tool_request",
+                tool: "test",
+                args: [],
+            };
+            const encoded = encodeMessage(msg);
+            expect(encoded).toBeInstanceOf(Buffer);
+        });
+    });
+    describe("decodeMessage", () => {
+        it("decodes ToolRequest", () => {
+            const json = '{"type":"tool_request","tool":"kv","args":["get","key"]}';
+            const msg = decodeMessage(json);
+            expect(msg.type).toBe("tool_request");
+            expect(msg.tool).toBe("kv");
+            expect(msg.args).toEqual(["get", "key"]);
+        });
+        it("decodes successful ToolResponse", () => {
+            const json = '{"type":"tool_response","success":true,"output":"value","exitCode":0}';
+            const msg = decodeMessage(json);
+            expect(msg.type).toBe("tool_response");
+            expect(msg.success).toBe(true);
+            expect(msg.output).toBe("value");
+            expect(msg.exitCode).toBe(0);
+        });
+        it("decodes error ToolResponse", () => {
+            const json = '{"type":"tool_response","success":false,"error":"Not found","exitCode":1}';
+            const msg = decodeMessage(json);
+            expect(msg.type).toBe("tool_response");
+            expect(msg.success).toBe(false);
+            expect(msg.error).toBe("Not found");
+            expect(msg.exitCode).toBe(1);
+        });
+        it("handles whitespace in input", () => {
+            const json = '  {"type":"tool_request","tool":"test","args":[]}  ';
+            const msg = decodeMessage(json);
+            expect(msg.type).toBe("tool_request");
+            expect(msg.tool).toBe("test");
+        });
+        it("throws on invalid JSON", () => {
+            expect(() => decodeMessage("not json")).toThrow();
+        });
+    });
+    describe("roundtrip encode/decode", () => {
+        it("roundtrips ToolRequest with empty args", () => {
+            const original = {
+                type: "tool_request",
+                tool: "status",
+                args: [],
+            };
+            const encoded = encodeMessage(original);
+            const decoded = decodeMessage(encoded.toString().trim());
+            expect(decoded).toEqual(original);
+        });
+        it("roundtrips ToolRequest with multiple args", () => {
+            const original = {
+                type: "tool_request",
+                tool: "kv",
+                args: ["set", "key1", "value with spaces", "more"],
+            };
+            const encoded = encodeMessage(original);
+            const decoded = decodeMessage(encoded.toString().trim());
+            expect(decoded).toEqual(original);
+        });
+        it("roundtrips ToolResponse with special characters in output", () => {
+            const original = {
+                type: "tool_response",
+                success: true,
+                output: "Line 1\nLine 2\tTabbed \"quoted\"",
+                exitCode: 0,
+            };
+            const encoded = encodeMessage(original);
+            const decoded = decodeMessage(encoded.toString().trim());
+            expect(decoded).toEqual(original);
+        });
+        it("roundtrips ToolResponse with unicode", () => {
+            const original = {
+                type: "tool_response",
+                success: true,
+                output: "Hello 🌍 世界",
+                exitCode: 0,
+            };
+            const encoded = encodeMessage(original);
+            const decoded = decodeMessage(encoded.toString().trim());
+            expect(decoded).toEqual(original);
+        });
+    });
+});
+//# sourceMappingURL=protocol.spec.js.map

package/dist/socket/protocol.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.spec.js","sourceRoot":"","sources":["../../src/socket/protocol.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAGL,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,GAAG,GAAgB;gBACvB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC;aAClC,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,GAAG,GAAiB;gBACxB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,CAAC;aACZ,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,GAAG,GAAiB;gBACxB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,QAAQ,EAAE,CAAC;aACZ,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,GAAG,GAAiB;gBACxB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,aAAa;gBACrB,KAAK,EAAE,SAAS;gBAChB,QAAQ,EAAE,CAAC;aACZ,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YACtD,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;YAC1B,MAAM,GAAG,GAAgB;gBACvB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,EAAE;aACT,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,IAAI,GAAG,0DAA0D,CAAC;YACxE,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAgB,CAAC;YAE/C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,IAAI,GAAG,uEAAuE,CAAC;YACrF,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAiB,CAAC;YAEhD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,IAAI,GAAG,2EAA2E,CAAC;YACzF,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAiB,CAAC;YAEhD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACpC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,IAAI,GAAG,qDAAqD,CAAC;YACnE,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAgB,CAAC;YAE/C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACvC,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,QAAQ,GAAgB;gBAC5B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,EAAE;aACT,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAgB,CAAC;YAExE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,QAAQ,GAAgB;gBAC5B,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC;aACnD,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAgB,CAAC;YAExE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,QAAQ,GAAiB;gBAC7B,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,mCAAmC;gBAC3C,QAAQ,EAAE,CAAC;aACZ,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAiB,CAAC;YAEzE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,QAAQ,GAAiB;gBAC7B,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,aAAa;gBACrB,QAAQ,EAAE,CAAC;aACZ,CAAC;YAEF,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAiB,CAAC;YAEzE,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/socket/server.d.ts

@@ -0,0 +1,21 @@
+import type { AuditLogger } from "../gateway/audit.js";
+import type { PolicyEngine } from "../gateway/policy.js";
+import type { ToolRunner } from "../tools/runner.js";
+/**
+ * Unix domain socket server for a single agent.
+ * Listens on a socket file, handles tool requests from sandbox launchers.
+ */
+export declare class AgentSocketServer {
+    private agentName;
+    private socketPath;
+    private audit;
+    private policy;
+    private toolRunner;
+    private server;
+    constructor(agentName: string, socketPath: string, audit: AuditLogger, policy: PolicyEngine, toolRunner: ToolRunner);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private handleConnection;
+    private handleToolRequest;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/socket/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/socket/server.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IAPpB,OAAO,CAAC,MAAM,CAAuB;gBAG3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,UAAU;IAGhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,OAAO,CAAC,gBAAgB;YA8CV,iBAAiB;CAgDhC"}

package/dist/socket/server.js

@@ -0,0 +1,133 @@
+import { createServer } from "net";
+import { mkdirSync, unlinkSync, existsSync } from "fs";
+import { dirname } from "path";
+import { encodeMessage, decodeMessage, } from "./protocol.js";
+/**
+ * Unix domain socket server for a single agent.
+ * Listens on a socket file, handles tool requests from sandbox launchers.
+ */
+export class AgentSocketServer {
+    agentName;
+    socketPath;
+    audit;
+    policy;
+    toolRunner;
+    server = null;
+    constructor(agentName, socketPath, audit, policy, toolRunner) {
+        this.agentName = agentName;
+        this.socketPath = socketPath;
+        this.audit = audit;
+        this.policy = policy;
+        this.toolRunner = toolRunner;
+    }
+    start() {
+        return new Promise((resolve, reject) => {
+            // Clean up stale socket file
+            if (existsSync(this.socketPath)) {
+                unlinkSync(this.socketPath);
+            }
+            mkdirSync(dirname(this.socketPath), { recursive: true });
+            this.server = createServer((socket) => {
+                this.handleConnection(socket);
+            });
+            this.server.on("error", reject);
+            this.server.listen(this.socketPath, () => {
+                console.log(`[SOCKET] Agent '${this.agentName}' listening on ${this.socketPath}`);
+                resolve();
+            });
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => {
+                    if (existsSync(this.socketPath)) {
+                        unlinkSync(this.socketPath);
+                    }
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    handleConnection(socket) {
+        let buffer = "";
+        socket.on("data", async (data) => {
+            buffer += data.toString();
+            // Process complete messages (newline-delimited)
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? ""; // Keep incomplete line in buffer
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const msg = decodeMessage(line);
+                    if (msg.type !== "tool_request") {
+                        socket.write(encodeMessage({
+                            type: "tool_response",
+                            success: false,
+                            error: `Unknown message type: ${msg.type}`,
+                            exitCode: 1,
+                        }));
+                        continue;
+                    }
+                    const response = await this.handleToolRequest(msg);
+                    socket.write(encodeMessage(response));
+                }
+                catch (err) {
+                    socket.write(encodeMessage({
+                        type: "tool_response",
+                        success: false,
+                        error: `Invalid request: ${err instanceof Error ? err.message : String(err)}`,
+                        exitCode: 1,
+                    }));
+                }
+            }
+        });
+        socket.on("error", (err) => {
+            console.error(`[SOCKET] Connection error for agent '${this.agentName}':`, err.message);
+        });
+    }
+    async handleToolRequest(req) {
+        const { tool, args } = req;
+        // Check policy
+        if (!this.policy.isToolAllowed(this.agentName, tool)) {
+            const timer = this.audit.start(this.agentName, "tool", tool, args, "denied");
+            timer.finish({ exitCode: 1, error: "Permission denied" });
+            return {
+                type: "tool_response",
+                success: false,
+                error: `Permission denied: tool '${tool}' is not allowed for agent '${this.agentName}'`,
+                exitCode: 1,
+            };
+        }
+        // Execute tool
+        const timer = this.audit.start(this.agentName, "tool", tool, args, "allowed", this.policy.getToolTarget(tool));
+        try {
+            const result = await this.toolRunner.run(tool, args, req.sessionContext);
+            timer.finish({
+                exitCode: result.exitCode,
+                outputBytes: Buffer.byteLength(result.output ?? ""),
+            });
+            return {
+                type: "tool_response",
+                success: result.exitCode === 0,
+                output: result.output,
+                exitCode: result.exitCode,
+            };
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            timer.finish({ exitCode: 1, error: errorMsg });
+            return {
+                type: "tool_response",
+                success: false,
+                error: errorMsg,
+                exitCode: 1,
+            };
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/socket/server.js.map

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

package/dist/socket/server.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.spec.d.ts.map

package/dist/socket/server.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.spec.d.ts","sourceRoot":"","sources":["../../src/socket/server.spec.ts"],"names":[],"mappings":""}