@intentface/latch-agent-builder 0.9.1

package/dist/extension.d.ts

@@ -0,0 +1,58 @@
+import type { AgentRecord } from "./record";
+/**
+ * The extension seam.
+ *
+ * The builder core is agent CRUD + discovery + test_agent. Anything beyond
+ * that — evals, tool authoring, connections, memory schemas, whatever a host
+ * grows next — plugs in here instead of being compiled into the core, so hosts
+ * without the feature get a builder that simply never mentions it. An
+ * extension contributes:
+ *
+ *  - tools:            merged into the builder's toolset (name-collision =
+ *                      extension wins; keep names distinct).
+ *  - promptSections:   appended verbatim to the builder's instructions.
+ *  - subagents:        delegate agents (e.g. "eval-author"). Subagents run
+ *                      autonomously; if the host auto-approves subagent tools
+ *                      or the extension's flows must never mutate state, keep
+ *                      the subagent READ-ONLY — persisting writes belong on
+ *                      the builder where user approval gates them.
+ *  - reservedNames:    agent names save_agent must refuse to overwrite.
+ *  - toolApproval:     HITL policy for the extension's own tools.
+ *  - validateSave:     veto a save_agent record (return an error string).
+ *  - decorate*Result:  append guidance to save_agent / test_agent results —
+ *                      the model acts on tool results far more reliably than
+ *                      on distant prompt instructions (e.g. eval nudges).
+ */
+type MaybePromise<T> = T | Promise<T>;
+export interface AgentBuilderExtension<P> {
+    /** Short id for diagnostics (e.g. "evals", "tool-authoring"). */
+    name: string;
+    /** Extra tools bound to the chatting user's principal. */
+    tools?: (principal: P) => MaybePromise<Record<string, unknown>>;
+    /** Instruction fragments appended to the builder's system prompt. */
+    promptSections?: string[];
+    /** Extra delegate agents (see read-only note above). */
+    subagents?: string[];
+    /** Agent names the builder must not overwrite (e.g. the extension's own subagents). */
+    reservedNames?: string[];
+    /** Per-tool approval policy for the extension's tools (merged into the builder's). */
+    toolApproval?: Record<string, unknown>;
+    /**
+     * Declares that this extension understands `exec.authoredTools`. Without
+     * any such extension the core REJECTS a non-empty `authoredTools` (a clear
+     * error beats silently dropping capabilities).
+     */
+    handlesAuthoredTools?: boolean;
+    /**
+     * Veto a save: return an error string to reject (surfaced as the tool
+     * result), or undefined to pass. Receives the NORMALIZED record about to be
+     * persisted; runs after the core validations.
+     */
+    validateSave?: (principal: P, record: AgentRecord) => MaybePromise<string | undefined>;
+    /** Amend the save_agent success result (e.g. append an eval nudge to `note`). */
+    decorateSaveResult?: (principal: P, agentName: string, result: Record<string, unknown>) => MaybePromise<Record<string, unknown>>;
+    /** Amend the test_agent result the same way. */
+    decorateTestResult?: (principal: P, agentName: string, result: Record<string, unknown>) => MaybePromise<Record<string, unknown>>;
+}
+export {};
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtC,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvF,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,CACnB,SAAS,EAAE,CAAC,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,CACnB,SAAS,EAAE,CAAC,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC5C"}

package/dist/extension.js

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

package/dist/extension.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createAgentBuilder } from "./agent-builder";
+export type { AgentBuilderConfig, AgentBuilderDeps, CapabilitySupport, ModelChoice, ConnectionChoice, } from "./agent-builder";
+export type { AgentBuilderExtension } from "./extension";
+export type { AgentBuilderStore } from "./store";
+export { AgentRecordSchema, AgentExecSchema, AgentToolsSchema, AgentScopeSchema, AttachedEvalSchema, MemoryConfigSchema, MemoryScopeSchema, EffortSchema, normalizeAgentName, normalizeAgentRecord, parseAgentRecord, parseAgentRef, } from "./record";
+export type { AgentRecord, AgentRecordInput, AgentScope, AttachedEval } from "./record";
+export { sharedReadTools } from "./shared-read-tools";
+export type { SharedReadDeps } from "./shared-read-tools";
+//# 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,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createAgentBuilder } from "./agent-builder";
+export { AgentRecordSchema, AgentExecSchema, AgentToolsSchema, AgentScopeSchema, AttachedEvalSchema, MemoryConfigSchema, MemoryScopeSchema, EffortSchema, normalizeAgentName, normalizeAgentRecord, parseAgentRecord, parseAgentRef, } from "./record";
+export { sharedReadTools } from "./shared-read-tools";
+//# 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,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAUrD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/record.d.ts

@@ -0,0 +1,230 @@
+import { z } from "zod";
+/**
+ * THE agent record — one zod schema that every writer and reader derives from:
+ * the persisted shape (`AgentRecord`), the builder's `save_agent` input, a
+ * host's server-side validator, and a schema-driven editor form. Declared once
+ * so a field can't exist in one home and not another.
+ *
+ * Zod-only on purpose (no `ai`, no runtime imports) — safe to ship to a
+ * browser bundle via the `./record` subpath.
+ *
+ * Two kinds of rule live here:
+ *  - shape + cross-field invariants that are TRUE FOR EVERY HOST (memory
+ *    connection must be wired, org-shared memory needs an org agent, index
+ *    schemas are outlines, …) → `AgentRecordSchema`.
+ *  - canonicalization every writer must apply → `normalizeAgentRecord`.
+ * Host policy (reserved names, who may attach org tools, which capabilities
+ * exist) stays with the host / the builder's `CapabilitySupport`.
+ */
+/** Where a record lives: the caller's personal scope or the shared org scope. */
+export declare const AgentScopeSchema: z.ZodEnum<{
+    user: "user";
+    org: "org";
+}>;
+export type AgentScope = z.infer<typeof AgentScopeSchema>;
+export declare const MemoryScopeSchema: z.ZodEnum<{
+    user: "user";
+    "agent-user": "agent-user";
+    "agent-org": "agent-org";
+}>;
+export declare const MemoryConfigSchema: z.ZodObject<{
+    scope: z.ZodEnum<{
+        user: "user";
+        "agent-user": "agent-user";
+        "agent-org": "agent-org";
+    }>;
+    connection: z.ZodString;
+    extractTo: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        user: "user";
+        "agent-user": "agent-user";
+        "agent-org": "agent-org";
+    }>>>;
+    schemas: z.ZodOptional<z.ZodObject<{
+        "agent-user": z.ZodOptional<z.ZodString>;
+        "agent-org": z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    extraction: z.ZodOptional<z.ZodObject<{
+        idleMinutes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    consolidation: z.ZodOptional<z.ZodObject<{
+        cooldownHours: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * One judge rubric attached to an agent. `trigger` is a host-defined predicate
+ * tree (see the host's eval feature) — opaque here; the host narrows it.
+ */
+export declare const AttachedEvalSchema: z.ZodObject<{
+    name: z.ZodString;
+    prompt: z.ZodString;
+    judgeModelId: z.ZodOptional<z.ZodString>;
+    scale: z.ZodDefault<z.ZodEnum<{
+        binary: "binary";
+        score: "score";
+    }>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    trigger: z.ZodOptional<z.ZodUnknown>;
+    context: z.ZodOptional<z.ZodEnum<{
+        turn: "turn";
+        chat: "chat";
+        loop: "loop";
+    }>>;
+}, z.core.$strip>;
+export type AttachedEval = z.infer<typeof AttachedEvalSchema>;
+/** Per-tool selection over the connections' tools. */
+export declare const AgentToolsSchema: z.ZodObject<{
+    enabled: z.ZodArray<z.ZodString>;
+    approval: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+    descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export declare const EffortSchema: z.ZodEnum<{
+    minimal: "minimal";
+    low: "low";
+    medium: "medium";
+    high: "high";
+}>;
+/** Code-execution + harness capabilities. Every flag is optional; absent = off. */
+export declare const AgentExecSchema: z.ZodObject<{
+    sandbox: z.ZodOptional<z.ZodBoolean>;
+    provider: z.ZodOptional<z.ZodString>;
+    defaultTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    disableTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    providerWebTools: z.ZodOptional<z.ZodBoolean>;
+    renderTools: z.ZodOptional<z.ZodBoolean>;
+    authoredTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    preApprovedWrites: z.ZodOptional<z.ZodBoolean>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    memory: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodEnum<{
+            user: "user";
+            "agent-user": "agent-user";
+            "agent-org": "agent-org";
+        }>;
+        connection: z.ZodString;
+        extractTo: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            user: "user";
+            "agent-user": "agent-user";
+            "agent-org": "agent-org";
+        }>>>;
+        schemas: z.ZodOptional<z.ZodObject<{
+            "agent-user": z.ZodOptional<z.ZodString>;
+            "agent-org": z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        extraction: z.ZodOptional<z.ZodObject<{
+            idleMinutes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        consolidation: z.ZodOptional<z.ZodObject<{
+            cooldownHours: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const AgentRecordSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    modelId: z.ZodString;
+    instructions: z.ZodString;
+    connections: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxSteps: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodLiteral<"unlimited">]>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodArray<z.ZodString>;
+        approval: z.ZodRecord<z.ZodString, z.ZodBoolean>;
+        descriptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>>;
+    exec: z.ZodOptional<z.ZodObject<{
+        sandbox: z.ZodOptional<z.ZodBoolean>;
+        provider: z.ZodOptional<z.ZodString>;
+        defaultTools: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+        disableTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        providerWebTools: z.ZodOptional<z.ZodBoolean>;
+        renderTools: z.ZodOptional<z.ZodBoolean>;
+        authoredTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        preApprovedWrites: z.ZodOptional<z.ZodBoolean>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            minimal: "minimal";
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        memory: z.ZodOptional<z.ZodObject<{
+            scope: z.ZodEnum<{
+                user: "user";
+                "agent-user": "agent-user";
+                "agent-org": "agent-org";
+            }>;
+            connection: z.ZodString;
+            extractTo: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                user: "user";
+                "agent-user": "agent-user";
+                "agent-org": "agent-org";
+            }>>>;
+            schemas: z.ZodOptional<z.ZodObject<{
+                "agent-user": z.ZodOptional<z.ZodString>;
+                "agent-org": z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            extraction: z.ZodOptional<z.ZodObject<{
+                idleMinutes: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            consolidation: z.ZodOptional<z.ZodObject<{
+                cooldownHours: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    subagents: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    attachedEvals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        prompt: z.ZodString;
+        judgeModelId: z.ZodOptional<z.ZodString>;
+        scale: z.ZodDefault<z.ZodEnum<{
+            binary: "binary";
+            score: "score";
+        }>>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        trigger: z.ZodOptional<z.ZodUnknown>;
+        context: z.ZodOptional<z.ZodEnum<{
+            turn: "turn";
+            chat: "chat";
+            loop: "loop";
+        }>>;
+    }, z.core.$strip>>>;
+    scope: z.ZodEnum<{
+        user: "user";
+        org: "org";
+    }>;
+}, z.core.$strict>;
+/** The persisted record — the schema's output type. */
+export type AgentRecord = z.infer<typeof AgentRecordSchema>;
+/** What a writer may pass in (defaults not yet applied). */
+export type AgentRecordInput = z.input<typeof AgentRecordSchema>;
+/**
+ * Canonical agent-name normalization — used by EVERY writer (host editors and
+ * the builder's save_agent) so the same intended name always maps to one
+ * record. Lowercased kebab, underscores allowed.
+ */
+export declare const normalizeAgentName: (s: string) => string;
+/**
+ * Channel bindings and run records pin an agent to one scope with an
+ * `org:`/`user:` prefix (stored names never contain `:` — normalizeAgentName
+ * strips it). Split a possibly-pinned reference.
+ */
+export declare function parseAgentRef(ref: string): {
+    name: string;
+    scope?: AgentScope;
+};
+/**
+ * Canonicalize a validated record before persisting. Idempotent. Every writer
+ * runs this so the stored form is the same regardless of who wrote it:
+ *  - name normalized; title/description trimmed (blank → absent)
+ *  - `exec.memory.extractTo` = unique levels, primary first (absent when it
+ *    would only repeat the primary); blank index schemas dropped
+ *  - empty `exec` / `subagents` / `schemas` → absent, not `{}` / `[]`
+ */
+export declare function normalizeAgentRecord(rec: AgentRecord): AgentRecord;
+/** Parse + normalize in one step — what a server-side writer wants. Throws `ZodError` on invalid input. */
+export declare function parseAgentRecord(input: unknown): AgentRecord;
+//# sourceMappingURL=record.d.ts.map

package/dist/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;GAgBG;AAEH,iFAAiF;AACjF,eAAO,MAAM,gBAAgB;;;EAA0B,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,iBAAiB;;;;EAA8C,CAAC;AAgB7E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAyB7B,CAAC;AAQH;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;iBAQ7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,sDAAsD;AACtD,eAAO,MAAM,gBAAgB;;;;iBAO3B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;EAA+C,CAAC;AAEzE,mFAAmF;AACnF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0B1B,CAAC;AASH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4C1B,CAAC;AAEL,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,MAAM,KAAG,MACqC,CAAC;AAErF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAG/E;AAaD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CA4BlE;AAED,2GAA2G;AAC3G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAE5D"}

package/dist/record.js

@@ -0,0 +1,217 @@
+import { z } from "zod";
+/**
+ * THE agent record — one zod schema that every writer and reader derives from:
+ * the persisted shape (`AgentRecord`), the builder's `save_agent` input, a
+ * host's server-side validator, and a schema-driven editor form. Declared once
+ * so a field can't exist in one home and not another.
+ *
+ * Zod-only on purpose (no `ai`, no runtime imports) — safe to ship to a
+ * browser bundle via the `./record` subpath.
+ *
+ * Two kinds of rule live here:
+ *  - shape + cross-field invariants that are TRUE FOR EVERY HOST (memory
+ *    connection must be wired, org-shared memory needs an org agent, index
+ *    schemas are outlines, …) → `AgentRecordSchema`.
+ *  - canonicalization every writer must apply → `normalizeAgentRecord`.
+ * Host policy (reserved names, who may attach org tools, which capabilities
+ * exist) stays with the host / the builder's `CapabilitySupport`.
+ */
+/** Where a record lives: the caller's personal scope or the shared org scope. */
+export const AgentScopeSchema = z.enum(["user", "org"]);
+export const MemoryScopeSchema = z.enum(["agent-user", "agent-org", "user"]);
+const MEMORY_LEVEL_DESCRIPTION = "'agent-user' = this agent's memory of each user (default choice); 'agent-org' = one shared memory for the whole org (requires the agent itself to have scope 'org'); 'user' = shared across all the user's agents.";
+/**
+ * Markdown index-schema outline: at least one real level-2 heading (`## ` +
+ * text, CommonMark requires the space), or blank (dropped on normalize).
+ */
+const isOutline = (s) => !s.trim() || /^[ \t]*##(?!#)[ \t]+\S/m.test(s);
+const MemorySchemaText = z
+    .string()
+    .max(4000, "Memory schema is too long (max 4000 chars).")
+    .refine(isOutline, 'Memory schema needs at least one "## Section" heading — it is the index outline.');
+export const MemoryConfigSchema = z.object({
+    scope: MemoryScopeSchema.describe(MEMORY_LEVEL_DESCRIPTION),
+    connection: z
+        .string()
+        .min(1)
+        .describe("Which of the agent's connections holds the memory files (must be in `connections`; typically 'loredex')."),
+    extractTo: z
+        .array(MemoryScopeSchema)
+        .optional()
+        .describe("EXTRA memory levels the background archivist also files facts into from the same conversations (the primary scope is always included). 'agent-org' here also requires the agent to have scope 'org'. Same connection for all levels."),
+    schemas: z
+        .strictObject({
+        "agent-user": MemorySchemaText.optional(),
+        "agent-org": MemorySchemaText.optional(),
+    })
+        .optional()
+        .describe("Markdown index-schema outlines per agent-held level ('## Section' headings + description bullets): what that level collects and how its MEMORY.md is organized. The shared 'user' level's schema is a workspace file, not agent config."),
+    extraction: z.object({ idleMinutes: z.number().int().positive().optional() }).optional(),
+    consolidation: z.object({ cooldownHours: z.number().positive().optional() }).optional(),
+});
+const _memoryConfigMatchesCore = true;
+void _memoryConfigMatchesCore;
+/**
+ * One judge rubric attached to an agent. `trigger` is a host-defined predicate
+ * tree (see the host's eval feature) — opaque here; the host narrows it.
+ */
+export const AttachedEvalSchema = z.object({
+    name: z.string().min(1).describe("Kebab-case id — becomes the score name."),
+    prompt: z.string().max(1000).describe("The judging instructions: one observable quality of a good response."),
+    judgeModelId: z.string().optional().describe("Judge model override (default: the host judge model)."),
+    scale: z.enum(["binary", "score"]).default("binary").describe("binary → pass/fail; score → graded 0–1."),
+    enabled: z.boolean().default(true),
+    trigger: z.unknown().optional().describe("When the judge runs — host-defined predicate; absent → every completed turn."),
+    context: z.enum(["turn", "chat", "loop"]).optional().describe("What the judge sees: turn (default), chat, or loop."),
+});
+/** Per-tool selection over the connections' tools. */
+export const AgentToolsSchema = z.object({
+    /** Namespaced tool names the model may call (empty → all). */
+    enabled: z.array(z.string()),
+    /** Per-tool override: true → require approval, false → waive it (overrides the connection default). */
+    approval: z.record(z.string(), z.boolean()),
+    /** Per-tool description overrides (by namespaced tool name). */
+    descriptions: z.record(z.string(), z.string()).optional(),
+});
+export const EffortSchema = z.enum(["minimal", "low", "medium", "high"]);
+/** Code-execution + harness capabilities. Every flag is optional; absent = off. */
+export const AgentExecSchema = z.object({
+    sandbox: z.boolean().optional().describe("Per-session workspace + file/shell tools (bash, read_file, …)."),
+    provider: z.string().optional().describe("Sandbox backend id (host-specific). Omit for the host default."),
+    defaultTools: z
+        .union([z.boolean(), z.array(z.string())])
+        .optional()
+        .describe("App harness tools (host-defined: e.g. web_fetch, askUser, scheduling). true = all of them, or a list of tool names."),
+    disableTools: z.array(z.string()).optional().describe("Harness tool names to opt out of."),
+    providerWebTools: z.boolean().optional().describe("Native provider web search/fetch (Anthropic/OpenAI/Google)."),
+    renderTools: z.boolean().optional().describe("Headless-browser fetch/render tool(s)."),
+    authoredTools: z
+        .array(z.string())
+        .optional()
+        .describe("Names of host-authored tools attached to this agent — only where the host offers tool authoring."),
+    preApprovedWrites: z
+        .boolean()
+        .optional()
+        .describe("Waive the per-call approval pause on this agent's WRITE tools — the save approval is the consent. ONLY for agents that must run unattended (schedules); requires defaultTools."),
+    effort: EffortSchema.optional().describe("Reasoning/thinking effort. Only set for a model where list_models shows reasoning=true."),
+    memory: MemoryConfigSchema.optional().describe("Persistent cross-session memory: the host archives durable facts from idle chats into the connection's workspace, injects a compiled index each turn, and adds memory_search/memory_save tools."),
+});
+// `strictObject`, not `object`: the pre-schema builder took `effort` and
+// `authoredTools` at the TOP level. Zod strips unknown keys by default, so a
+// writer still emitting that shape would save an agent silently missing its
+// configuration. Rejecting is the honest outcome. (`exec` itself stays
+// non-strict: a stored row carrying a retired flag such as `codeMode` is NOT
+// rejected — the unknown key is stripped on parse and simply not written back.
+// Nothing reads it anymore, so dropping it is the whole migration.)
+export const AgentRecordSchema = z
+    .strictObject({
+    name: z.string().min(1).describe("Unique kebab-case id. Reusing an existing name UPDATES that agent."),
+    title: z.string().optional().describe("Short human label for the picker."),
+    description: z.string().optional().describe("One line on what the agent does."),
+    modelId: z.string().min(1).describe("Must be an id returned by list_models."),
+    instructions: z.string().min(1).describe("The system prompt — the heart of the agent. Be specific."),
+    connections: z.array(z.string()).default([]).describe("Connection names from list_connections."),
+    maxSteps: z
+        .union([z.number().int().min(1), z.literal("unlimited")])
+        .optional()
+        .describe("Tool-loop ceiling: a number caps steps; \"unlimited\" runs until done; omit for the default."),
+    tools: AgentToolsSchema.optional(),
+    exec: AgentExecSchema.optional(),
+    subagents: z.array(z.string()).optional().describe("Names of agents this one may delegate to."),
+    attachedEvals: z.array(AttachedEvalSchema).optional(),
+    scope: AgentScopeSchema.describe("'user' (personal) or 'org' (shared). Ask the user — never guess."),
+})
+    .superRefine((rec, ctx) => {
+    if (!normalizeAgentName(rec.name)) {
+        ctx.addIssue({ code: "custom", path: ["name"], message: "invalid name" });
+    }
+    const mem = rec.exec?.memory;
+    if (!mem)
+        return;
+    // Memory files live in one of the agent's OWN connections. A dangling name
+    // would silently disable recall while looking configured.
+    if (!rec.connections.includes(mem.connection)) {
+        ctx.addIssue({
+            code: "custom",
+            path: ["exec", "memory", "connection"],
+            message: `Memory connection "${mem.connection}" must also be listed in the agent's connections.`,
+        });
+    }
+    // agent-org memory is keyed by agent name alone — restrict it to
+    // org-visible agents so same-named personal agents can't share a store.
+    // Applies to the primary scope AND every extraction level.
+    const levels = [mem.scope, ...(mem.extractTo ?? [])];
+    if (levels.includes("agent-org") && rec.scope !== "org") {
+        ctx.addIssue({
+            code: "custom",
+            path: ["exec", "memory", "scope"],
+            message: `Org-shared memory ('agent-org') requires scope: "org" on the agent itself.`,
+        });
+    }
+});
+/**
+ * Canonical agent-name normalization — used by EVERY writer (host editors and
+ * the builder's save_agent) so the same intended name always maps to one
+ * record. Lowercased kebab, underscores allowed.
+ */
+export const normalizeAgentName = (s) => s.trim().toLowerCase().replace(/[^a-z0-9_-]+/g, "-").replace(/^[-_]+|[-_]+$/g, "");
+/**
+ * Channel bindings and run records pin an agent to one scope with an
+ * `org:`/`user:` prefix (stored names never contain `:` — normalizeAgentName
+ * strips it). Split a possibly-pinned reference.
+ */
+export function parseAgentRef(ref) {
+    const m = /^(org|user):(.+)$/.exec(ref);
+    return m ? { name: m[2], scope: m[1] } : { name: ref };
+}
+const blankToUndefined = (s) => {
+    const t = s?.trim();
+    return t ? t : undefined;
+};
+/** Drop `undefined` values; return undefined when nothing is left. */
+function compact(obj) {
+    const out = Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+    return Object.keys(out).length ? out : undefined;
+}
+/**
+ * Canonicalize a validated record before persisting. Idempotent. Every writer
+ * runs this so the stored form is the same regardless of who wrote it:
+ *  - name normalized; title/description trimmed (blank → absent)
+ *  - `exec.memory.extractTo` = unique levels, primary first (absent when it
+ *    would only repeat the primary); blank index schemas dropped
+ *  - empty `exec` / `subagents` / `schemas` → absent, not `{}` / `[]`
+ */
+export function normalizeAgentRecord(rec) {
+    let exec = rec.exec ? { ...rec.exec } : undefined;
+    if (exec?.memory) {
+        const mem = { ...exec.memory };
+        const levels = [...new Set([mem.scope, ...(mem.extractTo ?? [])])];
+        mem.extractTo = levels.length > 1 ? levels : undefined;
+        if (mem.schemas) {
+            const kept = Object.fromEntries(Object.entries(mem.schemas).filter(([, s]) => s != null && s.trim()));
+            mem.schemas = Object.keys(kept).length ? kept : undefined;
+        }
+        exec.memory = compact(mem);
+    }
+    if (exec) {
+        if (exec.authoredTools && exec.authoredTools.length === 0)
+            exec.authoredTools = undefined;
+        if (exec.disableTools && exec.disableTools.length === 0)
+            exec.disableTools = undefined;
+        exec = compact(exec);
+    }
+    return {
+        ...rec,
+        name: normalizeAgentName(rec.name),
+        title: blankToUndefined(rec.title),
+        description: blankToUndefined(rec.description),
+        exec,
+        subagents: rec.subagents?.length ? rec.subagents : undefined,
+        attachedEvals: rec.attachedEvals?.length ? rec.attachedEvals : undefined,
+    };
+}
+/** Parse + normalize in one step — what a server-side writer wants. Throws `ZodError` on invalid input. */
+export function parseAgentRecord(input) {
+    return normalizeAgentRecord(AgentRecordSchema.parse(input));
+}
+//# sourceMappingURL=record.js.map

package/dist/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;GAgBG;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAGxD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAE7E,MAAM,wBAAwB,GAC5B,oNAAoN,CAAC;AAEvN;;;GAGG;AACH,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhF,MAAM,gBAAgB,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,IAAI,EAAE,6CAA6C,CAAC;KACxD,MAAM,CAAC,SAAS,EAAE,kFAAkF,CAAC,CAAC;AAEzG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,iBAAiB,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC3D,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,0GAA0G,CAC3G;IACH,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,iBAAiB,CAAC;SACxB,QAAQ,EAAE;SACV,QAAQ,CACP,sOAAsO,CACvO;IACH,OAAO,EAAE,CAAC;SACP,YAAY,CAAC;QACZ,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;QACzC,WAAW,EAAE,gBAAgB,CAAC,QAAQ,EAAE;KACzC,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,yOAAyO,CAC1O;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxF,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxF,CAAC,CAAC;AAKH,MAAM,wBAAwB,GAA6B,IAAI,CAAC;AAChE,KAAK,wBAAwB,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC7G,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACrG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACxG,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IACxH,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;CACrH,CAAC,CAAC;AAGH,sDAAsD;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,8DAA8D;IAC9D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,uGAAuG;IACvG,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,gEAAgE;IAChE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEzE,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC1G,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;IAC1G,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;SACzC,QAAQ,EAAE;SACV,QAAQ,CAAC,qHAAqH,CAAC;IAClI,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC1F,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IAChH,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACtF,aAAa,EAAE,CAAC;SACb,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,kGAAkG,CAAC;IAC/G,iBAAiB,EAAE,CAAC;SACjB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,gLAAgL,CACjL;IACH,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtC,yFAAyF,CAC1F;IACD,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC5C,iMAAiM,CAClM;CACF,CAAC,CAAC;AAEH,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,uEAAuE;AACvE,6EAA6E;AAC7E,+EAA+E;AAC/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,YAAY,CAAC;IACZ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACtG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC/E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC7E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0DAA0D,CAAC;IACpG,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAChG,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;SACxD,QAAQ,EAAE;SACV,QAAQ,CAAC,8FAA8F,CAAC;IAC3G,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC/F,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IACrD,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,kEAAkE,CAAC;CACrG,CAAC;KACD,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,2EAA2E;IAC3E,0DAA0D;IAC1D,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC;YACtC,OAAO,EAAE,sBAAsB,GAAG,CAAC,UAAU,mDAAmD;SACjG,CAAC,CAAC;IACL,CAAC;IACD,iEAAiE;IACjE,wEAAwE;IACxE,2DAA2D;IAC3D,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACxD,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC;YACjC,OAAO,EAAE,4EAA4E;SACtF,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAOL;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAS,EAAU,EAAE,CACtD,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAErF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAe,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,gBAAgB,GAAG,CAAC,CAAqB,EAAsB,EAAE;IACrE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3B,CAAC,CAAC;AAEF,sEAAsE;AACtE,SAAS,OAAO,CAAmB,GAAM;IACvC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAM,CAAC;IAC5F,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAgB;IACnD,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClD,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAC7B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAC7B,CAAC;YAC1C,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAe,CAAC;IAC3C,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;QAC1F,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QACvF,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,OAAO;QACL,GAAG,GAAG;QACN,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAClC,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC;QAClC,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC;QAC9C,IAAI;QACJ,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC5D,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;KACzE,CAAC;AACJ,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/shared-read-tools.d.ts

@@ -0,0 +1,16 @@
+import type { AgentBuilderStore } from "./store";
+/**
+ * Read-only discovery tools the builder shares with delegate agents (e.g. an
+ * eval author) — one implementation so the two can't drift. All are bound to
+ * the chatting user's principal; none mutate anything.
+ */
+export interface SharedReadDeps<P> {
+    store: AgentBuilderStore<P>;
+    /** Enumerate the tools a set of connections exposes, for this caller. */
+    connectionTools: (principal: P, names: string[]) => Promise<{
+        name: string;
+        description: string;
+    }[]>;
+}
+export declare function sharedReadTools<P>(principal: P, deps: SharedReadDeps<P>): Record<string, unknown>;
+//# sourceMappingURL=shared-read-tools.d.ts.map

package/dist/shared-read-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-read-tools.d.ts","sourceRoot":"","sources":["../src/shared-read-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;GAIG;AAEH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC5B,yEAAyE;IACzE,eAAe,EAAE,CAAC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;CACtG;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBjG"}

package/dist/shared-read-tools.js

@@ -0,0 +1,28 @@
+import { tool } from "ai";
+import { z } from "zod";
+export function sharedReadTools(principal, deps) {
+    return {
+        get_agent: tool({
+            description: "Get the full config of one of the user's agents (instructions, connections, exec capabilities).",
+            inputSchema: z.object({ name: z.string() }),
+            execute: async ({ name }) => {
+                // `getRecord` normalizes casing/spacing variants and honours an
+                // `org:`/`user:` pin; personal wins over org on a bare name.
+                const rec = await deps.store.getRecord(principal, name);
+                if (!rec)
+                    return { error: `No editable agent named "${name}".` };
+                return rec;
+            },
+        }),
+        list_connection_tools: tool({
+            description: "Enumerate the tools a set of connections exposes (to understand their capabilities).",
+            inputSchema: z.object({ connections: z.array(z.string()) }),
+            execute: async ({ connections }) => {
+                if (connections.length === 0)
+                    return [];
+                return deps.connectionTools(principal, connections);
+            },
+        }),
+    };
+}
+//# sourceMappingURL=shared-read-tools.js.map

package/dist/shared-read-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-read-tools.js","sourceRoot":"","sources":["../src/shared-read-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,MAAM,UAAU,eAAe,CAAI,SAAY,EAAE,IAAuB;IACtE,OAAO;QACL,SAAS,EAAE,IAAI,CAAC;YACd,WAAW,EAAE,iGAAiG;YAC9G,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC1B,gEAAgE;gBAChE,6DAA6D;gBAC7D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACxD,IAAI,CAAC,GAAG;oBAAE,OAAO,EAAE,KAAK,EAAE,4BAA4B,IAAI,IAAI,EAAE,CAAC;gBACjE,OAAO,GAAG,CAAC;YACb,CAAC;SACF,CAAC;QAEF,qBAAqB,EAAE,IAAI,CAAC;YAC1B,WAAW,EAAE,sFAAsF;YACnG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YAC3D,OAAO,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;gBACjC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACtD,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}