@looprun-ai/core 0.1.0

package/dist/spec.js

@@ -0,0 +1,168 @@
+/**
+ * @looprun-ai/core — the AgentSpec INTERFACE + class hierarchy (framework-free).
+ *
+ * The ruleset IS the spec (no compile step). A backend (e.g. @looprun-ai/mastra) consumes this
+ * interface directly, mapping each hook to a framework primitive:
+ *   onInput  → an input processor (abort ⇒ turn refused, no LLM call)
+ *   preTool  → a `beforeToolCall` veto ({ proceed:false, output: correction })
+ *   postTool → recorded via `afterToolCall`
+ *   onReply  → runtime finalization (bounded no-tools redrive; exhaustion ⇒ a deterministic
+ *              guard-authored closure)
+ *   controls → maxSteps (stop condition) · terminal (reply-only policy) · directives · escalate ·
+ *              exhaustionReply
+ *
+ * Layer hierarchy (guards installed by the constructor, layer-tagged and addressable):
+ *   AgentSpecMinimal — invariants EVERY agent carries: noDuplicateCall (preTool) + emptyReply (onReply).
+ *   AgentSpecBase    — Minimal + the destructive-safety protocol on `destructiveTools`:
+ *                      confirmFirst + destructiveThrottle.
+ *   AgentSpecFull    — Base + the schema-auto layer (argRequired/argFormat from tool JSON schemas).
+ * resolveBindings sorts each hook agent → full → base → minimal so an agent correction wins.
+ */
+import { argFormat, argRequired, confirmFirst, destructiveThrottle, emptyReply, noDuplicateCall } from './guards.js';
+const TERMINAL_TOOLS = ['replyToUser', 'askUser'];
+const LAYER_ORDER = { agent: 0, full: 1, base: 2, minimal: 3 };
+export function resolveBindings(bindings, tool) {
+    return (bindings ?? [])
+        .filter((b) => !b.disabled && (tool === undefined || b.target === 'any' || b.target.includes(tool)))
+        .sort((a, b) => LAYER_ORDER[a.layer] - LAYER_ORDER[b.layer]);
+}
+export function resolveGuards(bindings, tool) {
+    return resolveBindings(bindings, tool).map((b) => b.guard);
+}
+export function resolveMutators(bindings) {
+    return (bindings ?? [])
+        .filter((b) => !b.disabled)
+        .sort((a, b) => LAYER_ORDER[a.layer] - LAYER_ORDER[b.layer])
+        .map((b) => b.mutator);
+}
+export class AgentSpecMinimal {
+    id;
+    mode;
+    persona;
+    surface;
+    flow;
+    guards;
+    controls;
+    behavior;
+    theme;
+    destructiveTools;
+    toolSchemas;
+    seq = 0;
+    constructor(cfg) {
+        const terminals = cfg.tools.filter((t) => TERMINAL_TOOLS.includes(t));
+        if (terminals.length) {
+            throw new Error(`AgentSpec "${cfg.id}": terminal tools are runtime-owned and may not be in tools (found: ${terminals.join(', ')}).`);
+        }
+        if (!cfg.persona?.trim()) {
+            throw new Error(`AgentSpec "${cfg.id}": a non-empty per-agent persona is required — persona lives in the spec, never a shared theme (persona-on-spec law).`);
+        }
+        this.id = cfg.id;
+        this.mode = cfg.mode;
+        this.persona = cfg.persona;
+        // DESIGN RULE: every agent renders its OWN scoped prompt — no shared/global persona trunk.
+        this.surface = {
+            tools: [...cfg.tools],
+            // Theme-agnostic rendering: a spec never bakes theme strings into its prompt. If it ships no
+            // own renderer, the RUNTIME renders the scoped trunk with the theme (renderScopedSpecTrunk) —
+            // so the trunk carries ONLY what the spec/theme declare, and the domain skin stays outside
+            // the AgentSpec. `theme` here is a REFERENCE for DX, not content.
+            systemPrompt: cfg.systemPrompt,
+        };
+        this.flow = [...(cfg.flow ?? [])];
+        this.guards = { onInput: [], preTool: [], postTool: [], onReply: [], onReplyMutate: [] };
+        this.controls = {
+            ...(cfg.maxSteps != null ? { maxSteps: cfg.maxSteps } : {}),
+            ...(cfg.redrives != null ? { redrives: cfg.redrives } : {}),
+            ...(cfg.terminal ? { terminal: cfg.terminal } : {}),
+            ...(cfg.directives?.length ? { directives: [...cfg.directives] } : {}),
+            ...(cfg.escalate ? { escalate: cfg.escalate } : {}),
+            ...(cfg.exhaustionReply ? { exhaustionReply: cfg.exhaustionReply } : {}),
+        };
+        this.behavior = [...(cfg.behavior ?? [])];
+        if (cfg.theme)
+            this.theme = cfg.theme;
+        this.destructiveTools = [...(cfg.destructiveTools ?? [])];
+        this.toolSchemas = cfg.toolSchemas ?? {};
+        this.installMinimal();
+    }
+    installMinimal() {
+        this.addGuard('preTool', 'any', noDuplicateCall(), { layer: 'minimal', id: 'minimal:noDuplicateCall' });
+        this.addGuard('onReply', 'any', emptyReply(), { layer: 'minimal', id: 'minimal:emptyReply' });
+    }
+    addGuard(hook, target, guard, opts) {
+        if (hook === 'preTool' && (guard.dim === 'behavior' || guard.dim === 'output')) {
+            throw new Error(`AgentSpec "${this.id}": a '${guard.dim}'-dim guard (${guard.kind}) cannot be a preTool gate — use onReply/postTool.`);
+        }
+        const id = opts?.id ?? `${opts?.layer ?? 'agent'}:${guard.kind}#${++this.seq}`;
+        const all = [...this.guards.onInput, ...this.guards.preTool, ...this.guards.postTool, ...this.guards.onReply];
+        if (all.some((b) => b.id === id))
+            throw new Error(`AgentSpec guard id "${id}" already exists`);
+        this.guards[hook].push({ id, target, guard, layer: opts?.layer ?? 'agent', disabled: false });
+        return id;
+    }
+    addReplyCheck(guard, opts) {
+        return this.addGuard('onReply', 'any', guard, opts);
+    }
+    addMutator(mutator, opts) {
+        const id = opts?.id ?? `${opts?.layer ?? 'agent'}:${mutator.kind}#${++this.seq}`;
+        const list = (this.guards.onReplyMutate ??= []);
+        if (list.some((b) => b.id === id))
+            throw new Error(`AgentSpec mutator id "${id}" already exists`);
+        list.push({ id, mutator, layer: opts?.layer ?? 'agent', disabled: false });
+        return id;
+    }
+    get isPureGuardSet() {
+        const all = [...this.guards.onInput, ...this.guards.preTool, ...this.guards.postTool, ...this.guards.onReply];
+        return !all.some((b) => b.guard.kind.startsWith('llm:'));
+    }
+    addBehavior(line) {
+        this.behavior.push(line);
+        return this;
+    }
+    addFlow(edge) {
+        this.flow.push(edge);
+        return this;
+    }
+}
+export class AgentSpecBase extends AgentSpecMinimal {
+    constructor(cfg) {
+        super(cfg);
+        this.installBase();
+    }
+    installBase() {
+        const destructive = this.destructiveTools;
+        if (!destructive.length)
+            return;
+        const missing = destructive.filter((t) => !this.surface.tools.includes(t));
+        if (missing.length) {
+            throw new Error(`AgentSpec "${this.id}": destructiveTools not in the tool surface: ${missing.join(', ')}.`);
+        }
+        this.addGuard('preTool', destructive, confirmFirst(), { layer: 'base', id: 'base:confirmFirst' });
+        this.addGuard('preTool', destructive, destructiveThrottle(destructive), { layer: 'base', id: 'base:destructiveThrottle' });
+    }
+}
+export class AgentSpecFull extends AgentSpecBase {
+    constructor(cfg) {
+        super(cfg);
+        this.installFull();
+    }
+    installFull() {
+        for (const tool of this.surface.tools) {
+            const s = this.toolSchemas[tool];
+            if (!s)
+                continue;
+            for (const field of s.required ?? []) {
+                this.addGuard('preTool', [tool], argRequired(field), { layer: 'full', id: `full:argRequired:${tool}.${field}` });
+            }
+            for (const [field, prop] of Object.entries(s.properties ?? {})) {
+                if (!prop.pattern)
+                    continue;
+                try {
+                    this.addGuard('preTool', [tool], argFormat(field, prop.pattern), { layer: 'full', id: `full:argFormat:${tool}.${field}` });
+                }
+                catch { /* a malformed pattern degrades one guard, not the import */ }
+            }
+        }
+    }
+}
+//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

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

package/dist/trunk.d.ts

@@ -0,0 +1,35 @@
+import type { AgentSpec } from './spec.js';
+import type { AgentWorld } from './rules.js';
+/** The DOMAIN skin: the business-COMMON strings NOT derived from any single AgentSpec. Ideally
+ *  GENERATED by the agentspec skill from the business docs. Carries NO per-agent persona — that
+ *  lives on `spec.persona` (persona-on-spec law). */
+export interface TrunkTheme {
+    /** The business VOICE paragraph — the trunk's opening. BYTE-IDENTICAL across every agent of the
+     *  domain (trunk-static law: shared/static head, per-agent divergence as late as possible) and
+     *  case-invariant (no volatile world state — cacheable prefix). */
+    voice: string;
+    /** The volatile account/brand-state block — rendered by the runtime onto the USER MESSAGE tail. */
+    stateBlock(world: AgentWorld): string;
+    /** The always-render "## Core rules (NEVER violate)" invariants. */
+    coreInvariants: string[];
+    /** The final "## Output language (ABSOLUTE)" clause. */
+    languageClause: string;
+    /** Deterministic honest-abstain closure (verified observations only). */
+    exhaustionReply?: (world: AgentWorld, okTools: string[], produced: string[], violations: string[]) => string;
+}
+/** Linearize producer→consumer edges into an ordered node path (agent flows form simple chains). */
+export declare function chainOrder(edges: {
+    from: string;
+    to: string;
+}[]): string[];
+/**
+ * The SCOPED spec trunk — the BYTE-STABLE system prompt: the theme's shared VOICE (byte-identical
+ * across the domain's agents — trunk-static law) + the theme's core invariants + the spec's Flow /
+ * Tool rules / Governance / Behavior (the spec's per-agent persona/role line renders as the FIRST
+ * Behavior bullet — per-agent divergence as late as possible) + the theme's language clause.
+ * NO account/brand state (that rides the user message tail — state-in-tail). `_uploads` is accepted
+ * for signature compatibility but not rendered (upload labels also ride the user message).
+ * The theme resolves host-injected first, then `spec.theme`.
+ */
+export declare function renderScopedSpecTrunk(_world: AgentWorld, spec: AgentSpec, _uploads?: readonly string[], theme?: TrunkTheme): string;
+//# sourceMappingURL=trunk.d.ts.map

package/dist/trunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trunk.d.ts","sourceRoot":"","sources":["../src/trunk.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;qDAEqD;AACrD,MAAM,WAAW,UAAU;IACzB;;uEAEmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,mGAAmG;IACnG,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC;IACtC,oEAAoE;IACpE,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAC9G;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAkB1E;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,SAAS,MAAM,EAAO,EAChC,KAAK,CAAC,EAAE,UAAU,GACjB,MAAM,CA0BR"}

package/dist/trunk.js

@@ -0,0 +1,98 @@
+/**
+ * @looprun-ai/core — the DOMAIN-NEUTRAL trunk renderer + the `TrunkTheme` interface.
+ *
+ * This file contains ZERO business content — it is pure assembly machinery. Every business string
+ * comes from a GENERATED artifact with exactly one owner: the AgentSpec (persona / Flow / Tool rules /
+ * Governance / Behavior — per-agent) or the domain `TrunkTheme` (voice / core invariants / language /
+ * state-render mapping — common to a business's agents). The per-agent persona (role line,
+ * persona-on-spec law) lives on `spec.persona` and renders as the FIRST Behavior bullet; the shared
+ * business `voice` lives on the theme and opens the trunk — byte-identical across the domain's agents
+ * (trunk-static law: maximal shared prefix, per-agent divergence as late as possible).
+ *
+ * State-in-tail: `renderScopedSpecTrunk` renders ONLY case-invariant content, so the assembled
+ * system prompt is BYTE-STABLE across cases/turns of an agent (→ cacheable prefix). The volatile
+ * account/brand STATE (`theme.stateBlock`) is NOT rendered here — the runtime rides it on the USER
+ * MESSAGE tail (like upload labels), keeping the stable prefix intact. For that to hold, a spec's
+ * `persona` MUST be case-invariant (do not interpolate volatile world state into it).
+ */
+import { resolveBindings } from './spec.js';
+/** Linearize producer→consumer edges into an ordered node path (agent flows form simple chains). */
+export function chainOrder(edges) {
+    if (!edges.length)
+        return [];
+    const succ = new Map();
+    const hasPred = new Set();
+    for (const e of edges) {
+        succ.set(e.from, e.to);
+        hasPred.add(e.to);
+    }
+    const start = edges.map((e) => e.from).find((n) => !hasPred.has(n)) ?? edges[0].from;
+    const order = [];
+    const seen = new Set();
+    let cur = start;
+    while (cur && !seen.has(cur)) {
+        order.push(cur);
+        seen.add(cur);
+        cur = succ.get(cur);
+    }
+    return order;
+}
+function ruleSections(spec) {
+    const pre = resolveBindings(spec.guards.preTool);
+    const post = resolveBindings(spec.guards.postTool);
+    const all = [...pre, ...post];
+    const globals = all.filter((b) => b.target === 'any');
+    const globalSection = globals.length
+        ? `## Global tool rules\n${globals.map((b) => `- ${b.guard.prose()}.`).join('\n')}`
+        : null;
+    const lines = [];
+    for (const tool of spec.surface.tools) {
+        const scoped = all.filter((b) => b.target !== 'any' && b.target.includes(tool));
+        if (scoped.length)
+            lines.push(`- **${tool}**: ${scoped.map((b) => b.guard.prose()).join('; ')}.`);
+    }
+    const toolSection = lines.length ? `## Tool rules\n${lines.join('\n')}` : null;
+    return { globalSection, toolSection };
+}
+function governanceSection(spec, heading) {
+    const directives = spec.controls.directives ?? [];
+    if (!directives.length)
+        return null;
+    return `${heading}\n${directives.map((d) => `- IF ${d.cond} → ${d.directive}`).join('\n')}`;
+}
+/**
+ * The SCOPED spec trunk — the BYTE-STABLE system prompt: the theme's shared VOICE (byte-identical
+ * across the domain's agents — trunk-static law) + the theme's core invariants + the spec's Flow /
+ * Tool rules / Governance / Behavior (the spec's per-agent persona/role line renders as the FIRST
+ * Behavior bullet — per-agent divergence as late as possible) + the theme's language clause.
+ * NO account/brand state (that rides the user message tail — state-in-tail). `_uploads` is accepted
+ * for signature compatibility but not rendered (upload labels also ride the user message).
+ * The theme resolves host-injected first, then `spec.theme`.
+ */
+export function renderScopedSpecTrunk(_world, spec, _uploads = [], theme) {
+    const t = theme ?? spec.theme;
+    if (!t)
+        throw new Error('renderScopedSpecTrunk: a TrunkTheme is required (pass one, or set spec.theme).');
+    const parts = [
+        t.voice,
+        `## Core rules (NEVER violate)\n${t.coreInvariants.map((r) => `- ${r}`).join('\n')}`,
+    ];
+    const order = chainOrder(spec.flow);
+    if (order.length)
+        parts.push(`## Flow (call the tools in THIS order — do not skip a step)\n${order.join(' → ')}`);
+    const { globalSection, toolSection } = ruleSections(spec);
+    if (globalSection)
+        parts.push(globalSection);
+    if (toolSection)
+        parts.push(toolSection);
+    const gov = governanceSection(spec, '## Governance (deterministic — evaluate against the account state below)');
+    if (gov)
+        parts.push(gov);
+    // The per-agent persona (role line) leads the Behavior list — the LAST section before language,
+    // so agents of a domain share the maximal static prefix (trunk-static law).
+    const behaviorLines = [spec.persona, ...spec.behavior];
+    parts.push(`## Behavior\n${behaviorLines.map((b) => `- ${b}`).join('\n')}`);
+    parts.push(t.languageClause);
+    return parts.join('\n\n');
+}
+//# sourceMappingURL=trunk.js.map

package/dist/trunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trunk.js","sourceRoot":"","sources":["../src/trunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAsB5C,oGAAoG;AACpG,MAAM,UAAU,UAAU,CAAC,KAAqC;IAC9D,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,GAAG,GAAuB,KAAK,CAAC;IACpC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,IAAe;IACnC,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,GAAG,GAAmB,CAAC,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM;QAClC,CAAC,CAAC,yBAAyB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACnF,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAChF,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE/E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAe,EAAE,OAAe;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,OAAO,KAAK,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAkB,EAClB,IAAe,EACf,WAA8B,EAAE,EAChC,KAAkB;IAElB,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IAC1G,MAAM,KAAK,GAAa;QACtB,CAAC,CAAC,KAAK;QACP,kCAAkC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;KACrF,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,gEAAgE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElH,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEzC,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,EAAE,0EAA0E,CAAC,CAAC;IAChH,IAAI,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzB,gGAAgG;IAChG,4EAA4E;IAC5E,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,gBAAgB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE5E,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAE7B,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @looprun-ai/core — spec validation (the library-side spec laws).
+ *
+ * `validateSpec` returns warnings instead of throwing: a host decides strictness (LoopRunAgent's
+ * `strict: true` throws on any warning). Hard invariants (terminal tools in the surface, empty
+ * persona) already throw in the AgentSpec constructor.
+ */
+import type { AgentSpec } from './spec.js';
+export declare const MAX_TOOL_SURFACE = 15;
+export interface SpecWarning {
+    code: 'tool-surface-over-15' | 'empty-behavior' | 'duplicate-tools' | 'flow-tool-missing';
+    message: string;
+}
+export declare function validateSpec(spec: AgentSpec): SpecWarning[];
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,sBAAsB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAC1F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,EAAE,CAuC3D"}

package/dist/validate.js

@@ -0,0 +1,36 @@
+export const MAX_TOOL_SURFACE = 15;
+export function validateSpec(spec) {
+    const warnings = [];
+    if (spec.surface.tools.length > MAX_TOOL_SURFACE) {
+        warnings.push({
+            code: 'tool-surface-over-15',
+            message: `AgentSpec "${spec.id}": ${spec.surface.tools.length} tools exceed the ≤${MAX_TOOL_SURFACE} surface law — ` +
+                'split the agent by TOOL-NEED (never by user intent).',
+        });
+    }
+    const seen = new Set();
+    const dups = spec.surface.tools.filter((t) => (seen.has(t) ? true : (seen.add(t), false)));
+    if (dups.length) {
+        warnings.push({
+            code: 'duplicate-tools',
+            message: `AgentSpec "${spec.id}": duplicate tools in the surface: ${[...new Set(dups)].join(', ')}.`,
+        });
+    }
+    if (!spec.behavior.length) {
+        warnings.push({
+            code: 'empty-behavior',
+            message: `AgentSpec "${spec.id}": no behavior bullets — the persona alone rarely covers the agent's jobs.`,
+        });
+    }
+    const surface = new Set(spec.surface.tools);
+    const flowTools = spec.flow.flatMap((e) => [e.from, e.to]);
+    const missing = [...new Set(flowTools.filter((t) => !surface.has(t)))];
+    if (missing.length) {
+        warnings.push({
+            code: 'flow-tool-missing',
+            message: `AgentSpec "${spec.id}": flow references tools outside the surface: ${missing.join(', ')}.`,
+        });
+    }
+    return warnings;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAOnC,MAAM,UAAU,YAAY,CAAC,IAAe;IAC1C,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EACL,cAAc,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,sBAAsB,gBAAgB,iBAAiB;gBAC3G,sDAAsD;SACzD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3F,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,cAAc,IAAI,CAAC,EAAE,sCAAsC,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACrG,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,cAAc,IAAI,CAAC,EAAE,4EAA4E;SAC3G,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,cAAc,IAAI,CAAC,EAAE,iDAAiD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SACrG,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@looprun-ai/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "looprun core: the AgentSpec governance layer for LLM agents — typed deterministic guards (prose+check pairing), the byte-stable scoped trunk renderer, and the backend-agnostic governed-turn machine. Framework-free: zero runtime dependencies; backends (@looprun-ai/mastra, …) supply the loop.",
+  "keywords": [
+    "ai",
+    "agents",
+    "llm",
+    "governance",
+    "guardrails",
+    "agentspec",
+    "deterministic",
+    "guards"
+  ],
+  "license": "Apache-2.0",
+  "author": "LoopRun Team",
+  "homepage": "https://looprun.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/looprun-ai/looprun.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/looprun-ai/looprun/issues"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}