lorenz 0.1.0

package/packages/tool-sdk/dist/filter.js

@@ -0,0 +1,231 @@
+import { isRecord } from "@lorenz/domain";
+const MAX_FILTER_DEPTH = 12;
+const MAX_FILTER_NODES = 200;
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 1000;
+const COMPARE_OPS = new Set(["eq", "ne", "lt", "lte", "gt", "gte"]);
+const SET_OPS = new Set(["in", "nin"]);
+/**
+ * Validate untrusted agent input into a typed {@link Filter}, reconstructing each node so no
+ * stray properties survive. Throws a clear `Error` on malformed input or when the tree exceeds
+ * the depth/node bounds.
+ */
+export function parseFilter(input) {
+    return parseNode(input, 1, { nodes: 0 });
+}
+function parseNode(input, depth, state) {
+    if (depth > MAX_FILTER_DEPTH) {
+        throw new Error(`filter nesting exceeds ${MAX_FILTER_DEPTH} levels`);
+    }
+    if (++state.nodes > MAX_FILTER_NODES) {
+        throw new Error(`filter has more than ${MAX_FILTER_NODES} nodes`);
+    }
+    if (!isRecord(input))
+        throw new Error("filter: each node must be an object");
+    const hasAnd = "and" in input;
+    const hasOr = "or" in input;
+    const hasNot = "not" in input;
+    if (hasAnd || hasOr || hasNot) {
+        if (Object.keys(input).length !== 1) {
+            throw new Error("filter: a combinator node must have exactly one of 'and', 'or', or 'not'");
+        }
+        if (hasNot)
+            return { not: parseNode(input.not, depth + 1, state) };
+        const key = hasAnd ? "and" : "or";
+        const arr = input[key];
+        if (!Array.isArray(arr) || arr.length === 0) {
+            throw new Error(`filter: '${key}' must be a non-empty array of filters`);
+        }
+        const parsed = arr.map((node) => parseNode(node, depth + 1, state));
+        return hasAnd ? { and: parsed } : { or: parsed };
+    }
+    const field = input.field;
+    const op = input.op;
+    if (typeof field !== "string" || field === "") {
+        throw new Error("filter: predicate 'field' must be a non-empty string");
+    }
+    if (typeof op !== "string")
+        throw new Error("filter: predicate 'op' must be a string");
+    if (COMPARE_OPS.has(op)) {
+        if (!isScalar(input.value)) {
+            throw new Error(`filter: '${op}' value must be a string, number, boolean, or null`);
+        }
+        return { field, op: op, value: input.value };
+    }
+    if (SET_OPS.has(op)) {
+        const value = input.value;
+        if (!Array.isArray(value) || !value.every(isScalar)) {
+            throw new Error(`filter: '${op}' value must be an array of scalars`);
+        }
+        return { field, op: op, value: value };
+    }
+    if (op === "contains") {
+        if (typeof input.value !== "string") {
+            throw new Error("filter: 'contains' value must be a string");
+        }
+        if (input.ci !== undefined && typeof input.ci !== "boolean") {
+            throw new Error("filter: 'contains' ci must be a boolean");
+        }
+        return input.ci === undefined
+            ? { field, op: "contains", value: input.value }
+            : { field, op: "contains", value: input.value, ci: input.ci };
+    }
+    if (op === "exists") {
+        if (typeof input.value !== "boolean") {
+            throw new Error("filter: 'exists' value must be a boolean");
+        }
+        return { field, op: "exists", value: input.value };
+    }
+    throw new Error(`filter: unknown op '${op}'`);
+}
+/** Evaluate a validated {@link Filter} against a record. Side-effect free. */
+export function matchesFilter(record, filter) {
+    if ("and" in filter)
+        return filter.and.every((f) => matchesFilter(record, f));
+    if ("or" in filter)
+        return filter.or.some((f) => matchesFilter(record, f));
+    if ("not" in filter)
+        return !matchesFilter(record, filter.not);
+    return matchesPredicate(record, filter);
+}
+function matchesPredicate(record, p) {
+    // An unknown/undefined field is "absent": every comparison is false, mirroring linear_graphql's
+    // "ask for a field you do not have, get null" ergonomics. Only `exists:false` matches absence.
+    const present = Object.prototype.hasOwnProperty.call(record, p.field) && record[p.field] !== undefined;
+    if (!present)
+        return p.op === "exists" && p.value === false;
+    const raw = record[p.field];
+    switch (p.op) {
+        case "exists":
+            return p.value === true;
+        case "eq":
+            return scalarEq(raw, p.value);
+        case "ne":
+            return !scalarEq(raw, p.value);
+        case "lt":
+        case "lte":
+        case "gt":
+        case "gte": {
+            const c = compare(raw, p.value);
+            if (c === null)
+                return false;
+            if (p.op === "lt")
+                return c < 0;
+            if (p.op === "lte")
+                return c <= 0;
+            if (p.op === "gt")
+                return c > 0;
+            return c >= 0;
+        }
+        case "in":
+            return p.value.some((v) => scalarEq(raw, v));
+        case "nin":
+            return !p.value.some((v) => scalarEq(raw, v));
+        case "contains":
+            if (typeof raw === "string")
+                return strIncludes(raw, p.value, p.ci);
+            if (Array.isArray(raw))
+                return raw.some((el) => strIncludes(String(el), p.value, p.ci));
+            return false;
+    }
+}
+/**
+ * Parse the shared query envelope (`where`, `order_by`, `limit`, `offset`) from raw tool args.
+ * `select`, and any tracker-specific args, are parsed by the calling tool.
+ */
+export function parseQuerySpec(args) {
+    const spec = { orderBy: [], limit: DEFAULT_LIMIT, offset: 0 };
+    if (args.where !== undefined && args.where !== null)
+        spec.where = parseFilter(args.where);
+    if (args.order_by !== undefined)
+        spec.orderBy = parseOrderBy(args.order_by);
+    if (args.limit !== undefined)
+        spec.limit = parseLimit(args.limit);
+    if (args.offset !== undefined)
+        spec.offset = parseOffset(args.offset);
+    return spec;
+}
+/** Filter, then (stably) sort, then page a record list. Returns the page plus the pre-page total. */
+export function applyQuery(records, spec) {
+    let filtered = spec.where
+        ? records.filter((r) => matchesFilter(r, spec.where))
+        : records.slice();
+    if (spec.orderBy.length > 0)
+        filtered = sortRecords(filtered, spec.orderBy);
+    const total = filtered.length;
+    return { rows: filtered.slice(spec.offset, spec.offset + spec.limit), total };
+}
+/** Validate an optional `select` projection: an array of field-name strings, or undefined. */
+export function parseSelect(input) {
+    if (input === undefined || input === null)
+        return undefined;
+    if (!Array.isArray(input) || !input.every((s) => typeof s === "string")) {
+        throw new Error("select must be an array of field-name strings");
+    }
+    return input;
+}
+/** Project a record down to the named fields, dropping any the record does not have. */
+export function pickFields(record, fields) {
+    const out = {};
+    for (const f of fields) {
+        if (Object.prototype.hasOwnProperty.call(record, f))
+            out[f] = record[f];
+    }
+    return out;
+}
+function parseOrderBy(input) {
+    if (!Array.isArray(input))
+        throw new Error("order_by must be an array");
+    return input.map((item) => {
+        if (!isRecord(item) || typeof item.field !== "string" || item.field === "") {
+            throw new Error("order_by items must be { field: string, dir?: 'asc' | 'desc' }");
+        }
+        if (item.dir !== undefined && item.dir !== "asc" && item.dir !== "desc") {
+            throw new Error("order_by dir must be 'asc' or 'desc'");
+        }
+        return { field: item.field, dir: item.dir === "desc" ? "desc" : "asc" };
+    });
+}
+function parseLimit(input) {
+    if (typeof input !== "number" || !Number.isInteger(input) || input < 1) {
+        throw new Error("limit must be a positive integer");
+    }
+    return Math.min(input, MAX_LIMIT);
+}
+function parseOffset(input) {
+    if (typeof input !== "number" || !Number.isInteger(input) || input < 0) {
+        throw new Error("offset must be a non-negative integer");
+    }
+    return input;
+}
+function sortRecords(records, orderBy) {
+    return [...records].sort((a, b) => {
+        for (const { field, dir } of orderBy) {
+            const c = compare(a[field], b[field]);
+            if (c !== null && c !== 0)
+                return dir === "desc" ? -c : c;
+        }
+        return 0;
+    });
+}
+function scalarEq(a, b) {
+    return a === b;
+}
+/** Compare two values when both are numbers or both are strings; otherwise incomparable (null). */
+function compare(a, b) {
+    if (typeof a === "number" && typeof b === "number")
+        return a - b;
+    if (typeof a === "string" && typeof b === "string")
+        return a < b ? -1 : a > b ? 1 : 0;
+    return null;
+}
+function strIncludes(haystack, needle, ci) {
+    return ci ? haystack.toLowerCase().includes(needle.toLowerCase()) : haystack.includes(needle);
+}
+function isScalar(value) {
+    return (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean");
+}
+//# sourceMappingURL=filter.js.map

package/packages/tool-sdk/dist/filter.js.map

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

package/packages/tool-sdk/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { ToolContext, ToolProvider, ToolResult, ToolSpec } from "./provider.js";
+export { ToolRegistry, defaultToolRegistry, executeMountedTool, mountedToolSpecs, } from "./registry.js";
+export { toolFailure, toolSuccess, unsupportedToolFailure } from "./result.js";
+export { applyQuery, matchesFilter, parseFilter, parseQuerySpec, parseSelect, pickFields, } from "./filter.js";
+export type { Filter, QuerySpec } from "./filter.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/tool-sdk/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/packages/tool-sdk/dist/index.js

@@ -0,0 +1,4 @@
+export { ToolRegistry, defaultToolRegistry, executeMountedTool, mountedToolSpecs, } from "./registry.js";
+export { toolFailure, toolSuccess, unsupportedToolFailure } from "./result.js";
+export { applyQuery, matchesFilter, parseFilter, parseQuerySpec, parseSelect, pickFields, } from "./filter.js";
+//# sourceMappingURL=index.js.map

package/packages/tool-sdk/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC"}

package/packages/tool-sdk/dist/provider.d.ts

@@ -0,0 +1,51 @@
+import type { Settings } from "@lorenz/domain";
+/**
+ * JSON-Schema-shaped declaration of one agent-facing tool, served to agent sessions over
+ * the MCP endpoint.
+ */
+export interface ToolSpec {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Outcome of one tool invocation. `result` is returned to the agent verbatim; `error` is a
+ * human-readable summary set when `success` is false.
+ */
+export interface ToolResult {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+/** Dependencies handed to a tool pack when executing one of its tools. */
+export interface ToolContext {
+    settings: Settings;
+    fetchImpl: typeof fetch;
+}
+/**
+ * One named pack of agent-facing tools. Packs are registered in a {@link ToolRegistry}. The
+ * MCP endpoint always mounts the provider-neutral tracker pack, mounts the active tracker
+ * provider's declared default packs, and mounts any additional packs explicitly configured
+ * by the workflow's `tools:` map.
+ */
+export interface ToolProvider {
+    /** Pack name used by tracker providers' default mounts or by the workflow `tools:` map. */
+    readonly name: string;
+    /**
+     * Absolute skill directories this pack bundles. When the pack is mounted, the composition
+     * root overlays these into the workspace's skills directory alongside the configured
+     * `agent.skills`, so enabling a tool ships the skill that documents how to use it.
+     */
+    readonly skills?: readonly string[];
+    /**
+     * Validate this pack's per-pack config slice. Called once at startup by
+     * `validateDispatchConfig` for mounted packs that have configured options; throw with a
+     * `tools.<pack>.<key> ...` message on unknown keys or invalid values.
+     */
+    validateOptions?(options: Record<string, unknown>): void;
+    /** Tools this pack advertises for the given settings; may be empty. */
+    toolSpecs(settings: Settings): ToolSpec[];
+    /** Execute one of the tools declared by {@link toolSpecs}. */
+    executeTool(name: string, input: unknown, context: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/packages/tool-sdk/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,KAAK,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;OAIG;IACH,eAAe,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,uEAAuE;IACvE,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAC1C,8DAA8D;IAC9D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtF"}

package/packages/tool-sdk/dist/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/packages/tool-sdk/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":""}

package/packages/tool-sdk/dist/registry.d.ts

@@ -0,0 +1,35 @@
+import type { Settings } from "@lorenz/domain";
+import type { ToolContext, ToolProvider, ToolResult, ToolSpec } from "./provider.js";
+/**
+ * Lookup table of {@link ToolProvider}s keyed by pack name. The MCP server resolves the
+ * active tracker's mounted packs through a registry instead of hardcoding tool surfaces, so
+ * the set of mountable packs is decided by whoever composes the application.
+ */
+export declare class ToolRegistry {
+    private readonly providers;
+    /** Register a pack. Throws when a different pack already claims the name. */
+    register(provider: ToolProvider): void;
+    get(name: string | undefined): ToolProvider | undefined;
+    /** Like {@link get} but throws a config-style error listing the known pack names. */
+    require(name: string): ToolProvider;
+    names(): string[];
+}
+/**
+ * Process-wide registry used as the default by the MCP server and the CLI. The composition
+ * root registers packs here; library code only reads from it. Call sites that need
+ * isolation can construct their own {@link ToolRegistry} and pass it explicitly.
+ */
+export declare const defaultToolRegistry: ToolRegistry;
+/**
+ * Specs advertised by a set of mounted packs. Throws when two packs declare the same tool
+ * name: a mount is a single flat tool namespace, so collisions must fail loudly at mount
+ * time rather than shadow each other per call.
+ */
+export declare function mountedToolSpecs(packs: readonly ToolProvider[], settings: Settings): ToolSpec[];
+/**
+ * Route one tool call to the mounted pack that declares it. Unknown names report the full
+ * supported set; a throwing pack surfaces as a failed {@link ToolResult} (JSON-RPC
+ * `isError`), never as a transport-level error.
+ */
+export declare function executeMountedTool(packs: readonly ToolProvider[], name: string, input: unknown, context: ToolContext): Promise<ToolResult>;
+//# sourceMappingURL=registry.d.ts.map

package/packages/tool-sdk/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGrF;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAE7D,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAUtC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS;IAIvD,qFAAqF;IACrF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAanC,KAAK,IAAI,MAAM,EAAE;CAGlB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,cAAqB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAgB/F;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAcrB"}

package/packages/tool-sdk/dist/registry.js

@@ -0,0 +1,85 @@
+import { errorMessage } from "@lorenz/domain";
+import { toolFailure, unsupportedToolFailure } from "./result.js";
+/**
+ * Lookup table of {@link ToolProvider}s keyed by pack name. The MCP server resolves the
+ * active tracker's mounted packs through a registry instead of hardcoding tool surfaces, so
+ * the set of mountable packs is decided by whoever composes the application.
+ */
+export class ToolRegistry {
+    providers = new Map();
+    /** Register a pack. Throws when a different pack already claims the name. */
+    register(provider) {
+        const name = provider.name.trim();
+        if (!name)
+            throw new Error("tool provider name must not be blank");
+        const existing = this.providers.get(name);
+        if (existing && existing !== provider) {
+            throw new Error(`tool provider already registered for name: ${name}`);
+        }
+        this.providers.set(name, provider);
+    }
+    get(name) {
+        return name === undefined ? undefined : this.providers.get(name);
+    }
+    /** Like {@link get} but throws a config-style error listing the known pack names. */
+    require(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            const known = this.names();
+            const hint = known.length > 0
+                ? ` (known tool packs: ${known.join(", ")})`
+                : " (no tool packs registered - register tool packs at the composition root)";
+            throw new Error(`unsupported tool pack: ${name}${hint}`);
+        }
+        return provider;
+    }
+    names() {
+        return [...this.providers.keys()].sort();
+    }
+}
+/**
+ * Process-wide registry used as the default by the MCP server and the CLI. The composition
+ * root registers packs here; library code only reads from it. Call sites that need
+ * isolation can construct their own {@link ToolRegistry} and pass it explicitly.
+ */
+export const defaultToolRegistry = new ToolRegistry();
+/**
+ * Specs advertised by a set of mounted packs. Throws when two packs declare the same tool
+ * name: a mount is a single flat tool namespace, so collisions must fail loudly at mount
+ * time rather than shadow each other per call.
+ */
+export function mountedToolSpecs(packs, settings) {
+    const owners = new Map();
+    const specs = [];
+    for (const pack of packs) {
+        for (const spec of pack.toolSpecs(settings)) {
+            const owner = owners.get(spec.name);
+            if (owner !== undefined && owner !== pack.name) {
+                throw new Error(`tool name collision: ${spec.name} is declared by both the "${owner}" and "${pack.name}" packs`);
+            }
+            owners.set(spec.name, pack.name);
+            specs.push(spec);
+        }
+    }
+    return specs;
+}
+/**
+ * Route one tool call to the mounted pack that declares it. Unknown names report the full
+ * supported set; a throwing pack surfaces as a failed {@link ToolResult} (JSON-RPC
+ * `isError`), never as a transport-level error.
+ */
+export async function executeMountedTool(packs, name, input, context) {
+    for (const pack of packs) {
+        if (pack.toolSpecs(context.settings).some((spec) => spec.name === name)) {
+            try {
+                return await pack.executeTool(name, input, context);
+            }
+            catch (error) {
+                return toolFailure(errorMessage(error));
+            }
+        }
+    }
+    const supported = packs.flatMap((pack) => pack.toolSpecs(context.settings).map((spec) => spec.name));
+    return unsupportedToolFailure(name, supported);
+}
+//# sourceMappingURL=registry.js.map

package/packages/tool-sdk/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAI9C,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAElE;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACN,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAE7D,6EAA6E;IAC7E,QAAQ,CAAC,QAAsB;QAC7B,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,IAAwB;QAC1B,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,qFAAqF;IACrF,OAAO,CAAC,IAAY;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,GACR,KAAK,CAAC,MAAM,GAAG,CAAC;gBACd,CAAC,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC5C,CAAC,CAAC,2EAA2E,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,YAAY,EAAE,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA8B,EAAE,QAAkB;IACjF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,CAAC,IAAI,6BAA6B,KAAK,UAAU,IAAI,CAAC,IAAI,SAAS,CAChG,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA8B,EAC9B,IAAY,EACZ,KAAc,EACd,OAAoB;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACxE,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACtD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,WAAW,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1D,CAAC;IACF,OAAO,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC"}

package/packages/tool-sdk/dist/result.d.ts

@@ -0,0 +1,5 @@
+import type { ToolResult } from "./provider.js";
+export declare function toolSuccess(result: unknown): ToolResult;
+export declare function toolFailure(message: string, details?: Record<string, unknown>): ToolResult;
+export declare function unsupportedToolFailure(name: string, supportedTools: readonly string[]): ToolResult;
+//# sourceMappingURL=result.d.ts.map

package/packages/tool-sdk/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAEvD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,UAAU,CAM9F;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,UAAU,CAGZ"}

package/packages/tool-sdk/dist/result.js

@@ -0,0 +1,15 @@
+export function toolSuccess(result) {
+    return { success: true, result };
+}
+export function toolFailure(message, details = {}) {
+    return {
+        success: false,
+        error: message,
+        result: { error: { message, ...details } },
+    };
+}
+export function unsupportedToolFailure(name, supportedTools) {
+    const message = `Unsupported tool: ${JSON.stringify(name)}.`;
+    return toolFailure(message, { supportedTools: [...supportedTools] });
+}
+//# sourceMappingURL=result.js.map

package/packages/tool-sdk/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,MAAe;IACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,UAAmC,EAAE;IAChF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE;KAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,cAAiC;IAEjC,MAAM,OAAO,GAAG,qBAAqB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7D,OAAO,WAAW,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/packages/tool-sdk/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@lorenz/tool-sdk",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/domain": "file:../domain"
+  }
+}

package/packages/traceviz-emitter/dist/index.d.ts

@@ -0,0 +1,19 @@
+import type { AgentUpdate } from "@lorenz/domain";
+export declare class TraceEmitter {
+    private readonly traceDir;
+    private initialized;
+    /** Per-file write queues to avoid unbounded concurrent writes. */
+    private writeQueues;
+    private writeFailures;
+    constructor(traceDir: string);
+    emit(issueId: string, issueIdentifier: string, update: AgentUpdate): void;
+    drain(): Promise<void>;
+    clear(issueId: string): void;
+    private enqueue;
+    private asError;
+    private issueTracePaths;
+    private static issueDirPath;
+    private static resolveIssueTracePaths;
+    static tracePathForIssue(traceDir: string, issueId: string): string;
+}
+//# sourceMappingURL=index.d.ts.map

package/packages/traceviz-emitter/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAE9D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,WAAW,CAAqB;IACxC,kEAAkE;IAClE,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,aAAa,CAAe;gBAExB,QAAQ,EAAE,MAAM;IAI5B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IA4BnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAmB5B,OAAO,CAAC,OAAO;IAoBf,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,MAAM,CAAC,YAAY;IAU3B,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAGpE"}

package/packages/traceviz-emitter/dist/index.js

@@ -0,0 +1,97 @@
+import { mkdirSync, rmSync } from "node:fs";
+import { appendFile } from "node:fs/promises";
+import path from "node:path";
+export class TraceEmitter {
+    traceDir;
+    initialized = new Set();
+    /** Per-file write queues to avoid unbounded concurrent writes. */
+    writeQueues = new Map();
+    writeFailures = [];
+    constructor(traceDir) {
+        this.traceDir = traceDir;
+    }
+    emit(issueId, issueIdentifier, update) {
+        const { dirPath, filePath } = this.issueTracePaths(issueId);
+        const payload = {
+            type: update.type,
+            issueId,
+            issueIdentifier,
+            timestamp: update.timestamp ? update.timestamp.toISOString() : null,
+            message: update.message ?? null,
+            usage: update.usage ?? null,
+            workspacePath: update.workspacePath ?? null,
+            sessionId: update.sessionId ?? null,
+            executorPid: update.executorPid ?? null,
+        };
+        const line = JSON.stringify(payload);
+        this.enqueue(filePath, async () => {
+            if (!this.initialized.has(dirPath)) {
+                mkdirSync(dirPath, { recursive: true });
+                this.initialized.add(dirPath);
+            }
+            await appendFile(filePath, line + "\n");
+        }, `[TraceEmitter] Failed to write trace for issue ${issueIdentifier}:`);
+    }
+    async drain() {
+        await Promise.all([...this.writeQueues.values()]);
+        const failures = this.writeFailures.splice(0);
+        if (failures.length === 1) {
+            throw failures[0];
+        }
+        if (failures.length > 1) {
+            throw new AggregateError(failures, "Failed to write trace events");
+        }
+    }
+    clear(issueId) {
+        const { dirPath, filePath } = this.issueTracePaths(issueId);
+        const clearIssueDir = () => {
+            rmSync(dirPath, { recursive: true, force: true });
+            this.initialized.delete(dirPath);
+        };
+        if (!this.writeQueues.has(filePath)) {
+            clearIssueDir();
+            return;
+        }
+        this.enqueue(filePath, clearIssueDir, `[TraceEmitter] Failed to clear trace for issue ${issueId}:`);
+    }
+    enqueue(filePath, operation, errorMessage) {
+        const prev = this.writeQueues.get(filePath) ?? Promise.resolve();
+        const next = prev.then(operation).catch((err) => {
+            const error = this.asError(err, errorMessage);
+            this.writeFailures.push(error);
+            console.error(error.message, err);
+        });
+        this.writeQueues.set(filePath, next);
+        void next.finally(() => {
+            if (this.writeQueues.get(filePath) === next) {
+                this.writeQueues.delete(filePath);
+            }
+        });
+    }
+    asError(err, message) {
+        if (err instanceof Error) {
+            return new Error(`${message} ${err.message}`, { cause: err });
+        }
+        return new Error(`${message} ${String(err)}`);
+    }
+    issueTracePaths(issueId) {
+        return TraceEmitter.resolveIssueTracePaths(this.traceDir, issueId);
+    }
+    static issueDirPath(traceDir, issueId) {
+        const storageKey = encodeURIComponent(issueId);
+        const resolved = path.resolve(traceDir, storageKey);
+        const resolvedDir = path.resolve(traceDir);
+        if (!resolved.startsWith(resolvedDir + path.sep)) {
+            throw new Error(`Invalid issueId: path traversal detected`);
+        }
+        return resolved;
+    }
+    static resolveIssueTracePaths(traceDir, issueId) {
+        const dirPath = TraceEmitter.issueDirPath(traceDir, issueId);
+        return { dirPath, filePath: path.join(dirPath, "trace.jsonl") };
+    }
+    static tracePathForIssue(traceDir, issueId) {
+        return TraceEmitter.resolveIssueTracePaths(traceDir, issueId).filePath;
+    }
+}
+//# sourceMappingURL=index.js.map

package/packages/traceviz-emitter/dist/index.js.map

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