@inhuman.tools/plugin-sdk 0.0.0-stage → 0.1.0

package/dist/normalize.js

@@ -0,0 +1,220 @@
+import { z } from "zod";
+import { botCallToolDef, botDef, exclusiveSlotsDef, functionToolDef, inhumanBrand, inhumanShape, mcpServerDef, pluginProjectionDef, REASONING_EFFORTS, } from "./schemas/plugin.js";
+function parseNamed(schema, value, context) {
+    const result = schema.safeParse(value);
+    if (result.success)
+        return result.data;
+    const issue = result.error.issues[0];
+    throw new Error(`${context}: ${issue?.message ?? "invalid"}`);
+}
+function declaredRepresentation(value, fallback) {
+    return value === "tool" || value === "symbol" || value === "both" ? value : fallback;
+}
+export function isReasoningEffort(value) {
+    return z.enum(REASONING_EFFORTS).safeParse(value).success;
+}
+function toolRecord(value) {
+    if (value == null || typeof value !== "object")
+        return null;
+    if (value[inhumanBrand.tool] === true) {
+        const tool = value;
+        return tool.toToolDefinition();
+    }
+    return value;
+}
+function actionRecord(value) {
+    if (value == null || typeof value !== "object")
+        return null;
+    if (value[inhumanBrand.action] === true) {
+        const action = value;
+        return {
+            name: action.name,
+            description: action.description,
+            seat: action.seat,
+            input: action.input,
+            run: action.run,
+        };
+    }
+    return value;
+}
+function pluginBag(value) {
+    if (value == null || typeof value !== "object")
+        return null;
+    const record = value;
+    if (value[inhumanBrand.plugin] === true) {
+        const plugin = value;
+        return {
+            apiVersion: plugin.apiVersion,
+            tools: plugin.tools,
+            actions: plugin.actions,
+            envCapabilities: plugin.envCapabilities,
+            bots: plugin.bots,
+            mcpServers: plugin.mcpServers,
+            exclusiveSlots: plugin.exclusiveSlots,
+            projection: plugin.projection,
+        };
+    }
+    if ("default" in record && record.default != null)
+        return pluginBag(record.default);
+    return record;
+}
+export function validateSupportedVersion(bag, pluginName = "") {
+    const version = bag.apiVersion;
+    if (version === undefined)
+        return;
+    if (version === 1)
+        return;
+    throw new Error(`${pluginName}: unsupported plugin apiVersion ${String(version)}`);
+}
+function normalizeTool(raw, index, pluginName) {
+    const row = toolRecord(raw);
+    if (row == null)
+        throw new Error(`${pluginName}: tools[${index}] is not an object`);
+    if (row.type === "bot-message") {
+        throw new Error(`${pluginName}: tools[${index}] type bot-message is reserved in v1`);
+    }
+    const context = `${pluginName}: tools[${index}]`;
+    const parsed = row.type === "bot-call"
+        ? parseNamed(botCallToolDef, row, context)
+        : parseNamed(functionToolDef, row.type === "function" ? row : { ...row, type: undefined }, context);
+    const base = {
+        name: parsed.name,
+        description: parsed.description,
+        class: parsed.class,
+        representation: declaredRepresentation(parsed.representation, parsed.type === "bot-call" ? "tool" : "symbol"),
+        input: parsed.input,
+        output: parsed.output,
+        triggersReactLoop: parsed.triggersReactLoop !== false,
+        isSideChannel: parsed.isSideChannel === true,
+        tapeHidden: parsed.tapeHidden === true,
+        question: parsed.question,
+        effect: parsed.effect,
+        caption: parsed.caption,
+    };
+    if (parsed.type === "bot-call") {
+        return {
+            type: "bot-call",
+            ...base,
+            target: parsed.target,
+            prepare: parsed.prepare,
+            background: parsed.background === true,
+            lifetime: parsed.lifetime,
+            show: parsed.show,
+            deadlineMs: parsed.deadlineMs,
+            maxResultTokens: parsed.maxResultTokens,
+            supportsNotify: parsed.supportsNotify === true,
+        };
+    }
+    const exam = parsed.exam;
+    if (exam != null && parsed.run == null) {
+        return {
+            type: "function",
+            ...base,
+            exam,
+            run: () => {
+                throw new TypeError(`${pluginName}: tools[${index}] exam tools do not execute through run`);
+            },
+        };
+    }
+    return {
+        type: "function",
+        ...base,
+        exam,
+        run: parsed.run,
+    };
+}
+function normalizeProjection(raw, pluginName) {
+    if (raw == null)
+        return undefined;
+    return parseNamed(pluginProjectionDef, raw, `${pluginName}: projection`);
+}
+function parseExclusiveSlots(pluginName, bag) {
+    const raw = Array.isArray(bag.exclusiveSlots) ? bag.exclusiveSlots : [];
+    return parseNamed(exclusiveSlotsDef, raw, `${pluginName}: exclusiveSlots`);
+}
+export function normalizeDefinitions(exported, pluginName = "") {
+    const bag = pluginBag(exported);
+    if (bag == null)
+        throw new Error(`${pluginName}: plugin export is not an object`);
+    validateSupportedVersion(bag, pluginName);
+    const toolsRaw = Array.isArray(bag.tools) ? bag.tools : [];
+    const actionsRaw = Array.isArray(bag.actions) ? bag.actions : [];
+    const envRaw = Array.isArray(bag.envCapabilities) ? bag.envCapabilities : [];
+    const botsRaw = Array.isArray(bag.bots) ? bag.bots : [];
+    const serversRaw = Array.isArray(bag.mcpServers) ? bag.mcpServers : [];
+    const tools = toolsRaw.map((tool, index) => normalizeTool(tool, index, pluginName));
+    const toolNames = new Set();
+    for (const tool of tools) {
+        if (toolNames.has(tool.name))
+            throw new Error(`${pluginName}: tool "${tool.name}" collides`);
+        toolNames.add(tool.name);
+    }
+    const actions = actionsRaw.map((action, index) => {
+        const row = actionRecord(action);
+        if (row == null)
+            throw new Error(`${pluginName}: actions[${index}] is not an object`);
+        return parseNamed(inhumanShape.normalizedActionDef, row, `${pluginName}: actions[${index}]`);
+    });
+    const actionNames = new Set();
+    for (const action of actions) {
+        if (actionNames.has(action.name))
+            throw new Error(`${pluginName}: action "${action.name}" collides`);
+        actionNames.add(action.name);
+    }
+    const envCapabilities = envRaw.map((cap, index) => {
+        try {
+            return inhumanShape.envCapability.parse(cap);
+        }
+        catch {
+            throw new Error(`${pluginName}: envCapabilities[${index}] is invalid`);
+        }
+    });
+    const bots = botsRaw.map((bot, index) => parseNamed(botDef, bot, `${pluginName}: bots[${index}]`));
+    const botNames = new Set();
+    for (const bot of bots) {
+        if (botNames.has(bot.name))
+            throw new Error(`${pluginName}: bot "${bot.name}" collides`);
+        botNames.add(bot.name);
+    }
+    const mcpServers = serversRaw.map((server, index) => parseNamed(mcpServerDef, server, `${pluginName}: mcpServers[${index}]`));
+    const serverNames = new Set();
+    for (const server of mcpServers) {
+        if (serverNames.has(server.name))
+            throw new Error(`${pluginName}: mcpServer "${server.name}" collides`);
+        serverNames.add(server.name);
+    }
+    const projection = normalizeProjection(bag.projection, pluginName);
+    return {
+        apiVersion: 1,
+        tools,
+        bots,
+        mcpServers,
+        actions,
+        envCapabilities,
+        exclusiveSlots: parseExclusiveSlots(pluginName, bag),
+        projection,
+    };
+}
+export function resolveReferences(definition, pluginName = "") {
+    const botNames = new Set(definition.bots.map((bot) => bot.name));
+    const serverNames = new Set(definition.mcpServers.map((server) => server.name));
+    for (const tool of definition.tools) {
+        if (tool.type === "bot-call" && !botNames.has(tool.target)) {
+            throw new Error(`${pluginName}: tool "${tool.name}" target "${tool.target}" is unresolved`);
+        }
+    }
+    for (const bot of definition.bots) {
+        for (const binding of bot.mcp ?? []) {
+            if (!serverNames.has(binding.server)) {
+                throw new Error(`${pluginName}: bot "${bot.name}" binding server "${binding.server}" is unresolved`);
+            }
+        }
+        for (const target of bot.invokes ?? []) {
+            if (!botNames.has(target)) {
+                throw new Error(`${pluginName}: bot "${bot.name}" invokes unresolved "${target}"`);
+            }
+        }
+    }
+    return definition;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAW,MAAM,KAAK,CAAC;AAGjC,OAAO,EACL,cAAc,EACd,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAE7B,SAAS,UAAU,CAAI,MAAoB,EAAE,KAAc,EAAE,OAAe;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,KAAK,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,QAA4B;IAC1E,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvF,CAAC;AAqBD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC5D,CAAC;AAyFD,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAK,KAA2C,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,KAAmD,CAAC;QACjE,OAAO,IAAI,CAAC,gBAAgB,EAAwC,CAAC;IACvE,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5D,IAAK,KAA6C,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjF,MAAM,MAAM,GAAG,KAAmC,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;IACJ,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5D,MAAM,MAAM,GAAG,KAAwD,CAAC;IACxE,IAAK,KAA6C,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QACjF,MAAM,MAAM,GAAG,KASd,CAAC;QACF,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAA4B,EAAE,UAAU,GAAG,EAAE;IACpF,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC;IAC/B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO;IAClC,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO;IAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,mCAAmC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,aAAa,CAAC,GAAY,EAAE,KAAa,EAAE,UAAkB;IACpE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,GAAG,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,KAAK,oBAAoB,CAAC,CAAC;IACpF,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,KAAK,sCAAsC,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,UAAU,WAAW,KAAK,GAAG,CAAC;IACjD,MAAM,MAAM,GACV,GAAG,CAAC,IAAI,KAAK,UAAU;QACrB,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC;QAC1C,CAAC,CAAC,UAAU,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACxG,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,sBAAsB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC7G,KAAK,EAAE,MAAM,CAAC,KAAgB;QAC9B,MAAM,EAAE,MAAM,CAAC,MAAiB;QAChC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,KAAK,KAAK;QACrD,aAAa,EAAE,MAAM,CAAC,aAAa,KAAK,IAAI;QAC5C,UAAU,EAAE,MAAM,CAAC,UAAU,KAAK,IAAI;QACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,GAAG,IAAI;YACP,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAA2C;YAC3D,UAAU,EAAE,MAAM,CAAC,UAAU,KAAK,IAAI;YACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,cAAc,EAAE,MAAM,CAAC,cAAc,KAAK,IAAI;SAC/C,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAsC,CAAC;IAC3D,IAAI,IAAI,IAAI,IAAI,IAAI,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,GAAG,IAAI;YACP,IAAI;YACJ,GAAG,EAAE,GAAG,EAAE;gBACR,MAAM,IAAI,SAAS,CAAC,GAAG,UAAU,WAAW,KAAK,yCAAyC,CAAC,CAAC;YAC9F,CAAC;SACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,GAAG,IAAI;QACP,IAAI;QACJ,GAAG,EAAE,MAAM,CAAC,GAAoC;KACjD,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAY,EAAE,UAAkB;IAC3D,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAClC,OAAO,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE,GAAG,UAAU,cAAc,CAAqB,CAAC;AAC/F,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAkB,EAAE,GAA4B;IAC3E,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,OAAO,UAAU,CAAC,iBAAiB,EAAE,GAAG,EAAE,GAAG,UAAU,kBAAkB,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAiB,EAAE,UAAU,GAAG,EAAE;IACrE,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,GAAG,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,kCAAkC,CAAC,CAAC;IAClF,wBAAwB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC;QAC7F,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAC/C,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,GAAG,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,aAAa,KAAK,oBAAoB,CAAC,CAAC;QACtF,OAAO,UAAU,CAAC,YAAY,CAAC,mBAAmB,EAAE,GAAG,EAAE,GAAG,UAAU,aAAa,KAAK,GAAG,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,aAAa,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC;QACrG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,qBAAqB,KAAK,cAAc,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,UAAU,UAAU,KAAK,GAAG,CAAC,CAAC,CAAC;IACnG,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,UAAU,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC;QACzF,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAClD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,UAAU,gBAAgB,KAAK,GAAG,CAAC,CACxE,CAAC;IACF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,gBAAgB,MAAM,CAAC,IAAI,YAAY,CAAC,CAAC;QACxG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACnE,OAAO;QACL,UAAU,EAAE,CAAC;QACb,KAAK;QACL,IAAI;QACJ,UAAU;QACV,OAAO;QACP,eAAe;QACf,cAAc,EAAE,mBAAmB,CAAC,UAAU,EAAE,GAAG,CAAC;QACpD,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAsC,EAAE,UAAU,GAAG,EAAE;IACvF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,WAAW,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,MAAM,iBAAiB,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QAClC,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,UAAU,GAAG,CAAC,IAAI,qBAAqB,OAAO,CAAC,MAAM,iBAAiB,CAAC,CAAC;YACvG,CAAC;QACH,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,UAAU,GAAG,CAAC,IAAI,yBAAyB,MAAM,GAAG,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/projection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Trajectory projection ABI. The host runs each pack `reduce` over plugin
+ * metadata on the session graph. Hooks read the head projection and stamp the wire.
+ * This package does not import the session document.
+ */
+export type PluginProjection<S = unknown, A = unknown> = {
+    readonly initial: () => S;
+    readonly reduce: (state: S, action: A) => S;
+    /** Model-proposed metadata that may only be written sealed by the host. */
+    readonly hostOnly?: (action: A) => boolean;
+};
+/** Prefix projection at this invocation. `propose` is the action, not the next state. */
+export type PluginStorageHandles<S = unknown, A = unknown> = {
+    readonly session: S;
+    readonly invocation: S;
+    readonly project?: S;
+    readonly global?: S;
+    propose(action: A): void;
+};
+/** Host-computed exam result. Pack `settle` turns this into metadata. */
+export type ExamVerdict = {
+    readonly ok: boolean;
+    readonly comments: string;
+};
+/**
+ * Frozen exam admit. Host copies `program` into a ProgrammaticJob and
+ * seals `admit` onto that node. Model `expr` is ignored. `settle` is
+ * the sealed close — host does not know the pack's verdict action.
+ */
+export type ExamAdmit<TIn = unknown, S = unknown, A = unknown> = {
+    readonly program: (state: S, input: TIn) => string | {
+        readonly error: string;
+    };
+    readonly admit: (state: S, input: TIn) => A;
+    readonly settle?: (state: S, input: TIn, result: ExamVerdict) => A;
+};
+//# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI;IAC/D,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,MAAM,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChF,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,KAAK,CAAC,CAAC;CACpE,CAAC"}

package/dist/projection.js

@@ -0,0 +1,7 @@
+/**
+ * Trajectory projection ABI. The host runs each pack `reduce` over plugin
+ * metadata on the session graph. Hooks read the head projection and stamp the wire.
+ * This package does not import the session document.
+ */
+export {};
+//# sourceMappingURL=projection.js.map

package/dist/projection.js.map

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

package/dist/schemas/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,2 @@
+export * from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}