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

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+# `@inhuman.tools/plugin-sdk`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Tools, actions, bots, and bundled MCP. Not the host, not `plugin.json`.
+
+## Public surface
+
+Bot `instructions` is `SystemPrompt` from `@inhuman.tools/harness-commons` — `` prompt.system`…` ``. User-turn text is `UserPrompt`.
+
+```ts
+import {
+  InhumanAction,
+  InhumanPlugin,
+  InhumanTool,
+  normalizeDefinitions,
+  resolveReferences,
+  validateSupportedVersion,
+  z,
+  type BotDefinition,
+  type McpServerDefinition,
+  type PluginCallContext,
+  type ToolDefinition,
+} from "@inhuman.tools/plugin-sdk";
+
+const search = new InhumanTool({
+  type: "function",
+  name: "example_search",
+  class: "read",
+  input: z.object({ q: z.string() }),
+  output: z.object({ ok: z.boolean() }),
+  async run(input, ctx) {
+    return { ok: true };
+  },
+});
+
+const recall = new InhumanTool({
+  type: "bot-call",
+  name: "tingle",
+  target: "scout",
+  input: z.object({ prompt: z.string() }),
+  output: z.object({ kind: z.literal("miss") }),
+  prepare: (input, ctx) => ({ prompt: input.prompt }),
+  background: true,
+  lifetime: "turn",
+  show: "turn",
+  deadlineMs: 5_000,
+  supportsNotify: false,
+});
+
+export default new InhumanPlugin({
+  apiVersion: 1,
+  tools: [search, recall],
+  bots: [{ name: "scout", scope: "invocation", instructions: "…" }],
+  actions: [new InhumanAction({ name: "simplify", run: async () => ({ ok: true }) })],
+});
+```
+
+## Tool kinds
+
+| `type` | Body | Host admit path |
+|--------|------|-----------------|
+| `"function"` (default when `run` only) | `run(input, ctx)` | `tool.execute(raw, ctx)` |
+| `"bot-call"` | `prepare(input, ctx)` optional; `target` names a local bot | licensed AgentCall; no public `call__…` wrapper |
+
+## Plugin bag fields
+
+| Field | Role |
+|-------|------|
+| `tools` | catalog verbs (`function` or `bot-call`) |
+| `bots` | named workers compiled into internal recipes |
+| `mcpServers` | bundled stdio MCP; `visibility: "private"` \| `"public"` |
+| `exclusiveSlots` | mutual exclusion (e.g. one foreground memory provider) |
+| `actions` | named JSON-RPC actions |
+| `envCapabilities` | rare Arrival env extensions |
+| `projection` | reducer + loop-end hooks over trajectory metadata |
+
+Tool flags (not `class`):
+
+| Flag | Default | Role |
+|------|---------|------|
+| `triggersReactLoop` | `true` | `false` = not work (same-round, not a ReACT continuer). Only host side-channel names skip the license |
+| `tapeHidden` | `false` | off the tape. Separate bit. |
+| `question` / `effect` / `caption` | — | Mustache tape faces. Kernel projects them onto `PluginSpec`. Empty = uncovered. |
+| `exam` | — | admit as a frozen ProgrammaticJob; host seals `admit`, then `settle` on close |
+
+`ctx.storage` is the prefix projection for this plugin. `propose(action)` writes metadata onto **this** job. The next state is the computed projection, not a field.
+
+## Callbacks (named points only)
+
+- `run` — native function tool body
+- `prepare` — bot-call input derivation with graph context (`turn`, `completion`, `invocation`)
+- `transport.env` — bundled MCP child environment
+
+Rejected: routing closures (`writer.tool()`), object-identity targets, treating `show: "omit"` as a marker hint.
+
+## Load boundary
+
+Constructors and plain records normalize identically:
+
+```text
+validateSupportedVersion → normalizeDefinitions → resolveReferences → install
+```
+
+Also: `defineTool` / `defineAction`, brand guards, re-export of `z`. `envCapabilities` is optional (`@here.build/arrival` peer).
+
+The daemon parses `extensions.tools.inhuman` and `import`s this module. This package does not import harness-server or harness-sdk at runtime.

package/dist/index.d.ts

@@ -0,0 +1,153 @@
+/**
+ * @inhuman.tools/plugin-sdk — tools, actions, envCapabilities.
+ *
+ * `export default new InhumanPlugin({ tools, actions, envCapabilities? })`.
+ * plugin.json extension format is the daemon's. This package does not parse it.
+ * `envCapabilities` is optional and rare: Arrival `EnvCapability` instances
+ * (`@here.build/arrival`, optional peer).
+ */
+import type { EnvCapability } from "@here.build/arrival";
+import { z } from "zod";
+import { type BotDefinition, type McpServerDefinition, type NormalizedPluginDefinition, type PluginCallContext, type ToolDefinition } from "./normalize.js";
+import { type ExamAdmit, type PluginProjection } from "./projection.js";
+import { inhumanBrand, NormalizedActionDefinition, type ToolRepresentation } from "./schemas/plugin.js";
+export * from "./schemas/index.js";
+export { normalizeDefinitions as normalizeDefinitions, resolveReferences as resolveReferences, type BotCallToolDefinition as BotCallToolDefinition, type BotDefinition as BotDefinition, isReasoningEffort as isReasoningEffort, type ReasoningEffort as ReasoningEffort, type NormalizedPluginDefinition as NormalizedPluginDefinition, type PluginCallContext as PluginCallContext, type ToolDefinition as ToolDefinition, } from "./normalize.js";
+export { type ExamAdmit as ExamAdmit, type PluginProjection as PluginProjection, type PluginStorageHandles as PluginStorageHandles, } from "./projection.js";
+/** Coarse class for hooks / tolerance axes (open string for packs). */
+export type ToolClass = "read" | "write" | "effect" | (string & {});
+/** Host-provided membrane — not freestyle process ambient. */
+export type ToolContext = PluginCallContext;
+export type InhumanToolDef<TIn, TOut> = {
+    readonly name: string;
+    readonly description?: string;
+    /** Catalog class (`read` | `write` | `effect` | …). Missing → `effect`. */
+    readonly class?: ToolClass;
+    /**
+     * `tool` is a JSON function in completions tools[]. `symbol` is a scheme_repl
+     * name and stays off tools[]. `both` is both. Omitted function tools are
+     * symbols. Omitted bot-calls are tools.
+     */
+    readonly representation?: ToolRepresentation;
+    readonly input: z.ZodType<TIn>;
+    readonly output: z.ZodType<TOut>;
+    readonly type?: "function" | "bot-call";
+    readonly run?: (input: TIn, ctx: ToolContext) => Promise<TOut> | TOut;
+    readonly target?: string;
+    readonly prepare?: (input: TIn, ctx: ToolContext) => unknown;
+    readonly background?: boolean;
+    readonly lifetime?: "turn" | "call";
+    readonly show?: "result" | "omit" | "turn";
+    readonly deadlineMs?: number;
+    readonly maxResultTokens?: number;
+    readonly supportsNotify?: boolean;
+    /**
+     * When false the call is not a ReACT continuer by itself. Default true.
+     * Not `class`. License skip is `isSideChannel`.
+     */
+    readonly triggersReactLoop?: boolean;
+    /** Skips the license floor. Default false. */
+    readonly isSideChannel?: boolean;
+    /** Off the tape. Separate from `triggersReactLoop`. Default false. */
+    readonly tapeHidden?: boolean;
+    /**
+     * Mustache tape faces. Null or omitted is uncovered — the TUI falls
+     * through. Kernel projects these onto `PluginSpec`. pretty-mcp grain:
+     * `question` while live/ask, `effect` when sealed, `caption` the
+     * collapsed token.
+     */
+    readonly question?: string | null;
+    readonly effect?: string | null;
+    readonly caption?: string | null;
+    /** Admit as a frozen exam bag. Host stamps `admit` sealed on that job. */
+    readonly exam?: ExamAdmit<TIn, unknown, unknown>;
+};
+export declare class InhumanTool<TIn = unknown, TOut = unknown> {
+    readonly [inhumanBrand.tool]: true;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly class: ToolClass;
+    readonly representation: ToolRepresentation;
+    readonly input: z.ZodType<TIn>;
+    readonly output: z.ZodType<TOut>;
+    readonly type: "function" | "bot-call";
+    readonly target?: string;
+    readonly prepare?: (input: TIn, ctx: ToolContext) => unknown;
+    readonly background?: boolean;
+    readonly lifetime?: "turn" | "call";
+    readonly show?: "result" | "omit" | "turn";
+    readonly deadlineMs?: number;
+    readonly maxResultTokens?: number;
+    readonly supportsNotify?: boolean;
+    readonly triggersReactLoop: boolean;
+    readonly tapeHidden: boolean;
+    private readonly sideChannel;
+    readonly question: string | null;
+    readonly effect: string | null;
+    readonly caption: string | null;
+    readonly exam?: ExamAdmit<TIn, unknown, unknown>;
+    private readonly _run?;
+    constructor(def: InhumanToolDef<TIn, TOut>);
+    /** Host side channel. Skips the license floor. */
+    get isSideChannel(): boolean;
+    /** Normalized ABI record for load-boundary comparisons. */
+    toToolDefinition(): ToolDefinition<TIn, TOut>;
+    /** Parse raw args → run → parse output. Host admit path uses this. */
+    execute(raw: unknown, ctx?: ToolContext): Promise<TOut>;
+}
+export declare function defineTool<TIn, TOut>(def: InhumanToolDef<TIn, TOut>): InhumanTool<TIn, TOut>;
+/** Host membrane for a JS action. Not a completion door. */
+export type ActionContext = {
+    readonly signal?: AbortSignal;
+    readonly [key: string]: unknown;
+};
+export type ActionFn<TArgs = unknown, TOut = unknown> = (args: TArgs, ctx: ActionContext) => TOut | Promise<TOut>;
+export type ActionSeat = "session" | "harness";
+declare const actionBrand: symbol;
+export type InhumanActionDef<TArgs = unknown, TOut = unknown> = {
+    readonly name: string;
+    readonly description?: string;
+    readonly seat?: ActionSeat;
+    readonly input?: z.ZodType<TArgs>;
+    readonly run: ActionFn<TArgs, TOut>;
+};
+export declare class InhumanAction<TArgs = unknown, TOut = unknown> {
+    readonly [actionBrand]: true;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly seat: ActionSeat;
+    readonly input: z.ZodType<TArgs> | undefined;
+    readonly run: ActionFn<TArgs, TOut>;
+    constructor(def: InhumanActionDef<TArgs, TOut>);
+}
+export declare function defineAction<TArgs, TOut>(def: InhumanActionDef<TArgs, TOut>): InhumanAction<TArgs, TOut>;
+/** Plugin bag accepts any tool arity; the constructor normalizes to erased instances. */
+export type AnyInhumanTool = InhumanTool<any, any>;
+export type InhumanPluginDef = {
+    readonly apiVersion?: 1;
+    readonly tools?: readonly AnyInhumanTool[];
+    readonly actions?: readonly (InhumanAction | NormalizedActionDefinition)[];
+    readonly envCapabilities?: readonly EnvCapability[];
+    readonly bots?: readonly BotDefinition[];
+    readonly mcpServers?: readonly McpServerDefinition[];
+    readonly exclusiveSlots?: readonly string[];
+    /** Pack projection over trajectory metadata plus wire stamps from the head projection. */
+    readonly projection?: PluginProjection<any, any>;
+};
+declare const pluginBrand: symbol;
+export declare class InhumanPlugin {
+    readonly [pluginBrand]: true;
+    readonly apiVersion: 1;
+    readonly tools: readonly InhumanTool[];
+    readonly actions: readonly InhumanAction[];
+    readonly envCapabilities: readonly EnvCapability[];
+    readonly bots: readonly BotDefinition[];
+    readonly mcpServers: readonly McpServerDefinition[];
+    readonly exclusiveSlots: readonly string[];
+    readonly projection?: PluginProjection<any, any>;
+    readonly definition: NormalizedPluginDefinition;
+    constructor(def?: InhumanPluginDef);
+    static isInhumanPlugin(value: unknown): value is InhumanPlugin;
+}
+export { z as z } from "zod";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,187 @@
+/**
+ * @inhuman.tools/plugin-sdk — tools, actions, envCapabilities.
+ *
+ * `export default new InhumanPlugin({ tools, actions, envCapabilities? })`.
+ * plugin.json extension format is the daemon's. This package does not parse it.
+ * `envCapabilities` is optional and rare: Arrival `EnvCapability` instances
+ * (`@here.build/arrival`, optional peer).
+ */
+import { normalizeDefinitions, resolveReferences, } from "./normalize.js";
+import { inhumanBrand, inhumanShape } from "./schemas/plugin.js";
+export * from "./schemas/index.js";
+export { normalizeDefinitions as normalizeDefinitions, resolveReferences as resolveReferences, isReasoningEffort as isReasoningEffort, } from "./normalize.js";
+export class InhumanTool {
+    [inhumanBrand.tool] = true;
+    name;
+    description;
+    class;
+    representation;
+    input;
+    output;
+    type;
+    target;
+    prepare;
+    background;
+    lifetime;
+    show;
+    deadlineMs;
+    maxResultTokens;
+    supportsNotify;
+    triggersReactLoop;
+    tapeHidden;
+    sideChannel;
+    question;
+    effect;
+    caption;
+    exam;
+    _run;
+    constructor(def) {
+        const normalized = normalizeDefinitions({ tools: [def], actions: [], envCapabilities: [] }, "InhumanTool")
+            .tools[0];
+        this.name = normalized.name;
+        this.description = normalized.description;
+        this.class = normalized.class ?? "effect";
+        this.representation = normalized.representation;
+        this.input = normalized.input;
+        this.output = normalized.output;
+        this.type = normalized.type;
+        if (normalized.type === "function") {
+            this._run = normalized.run;
+        }
+        else {
+            this.target = normalized.target;
+            this.prepare = normalized.prepare;
+            this.background = normalized.background;
+            this.lifetime = normalized.lifetime;
+            this.show = normalized.show;
+            this.deadlineMs = normalized.deadlineMs;
+            this.maxResultTokens = normalized.maxResultTokens;
+            this.supportsNotify = normalized.supportsNotify;
+        }
+        this.triggersReactLoop = normalized.triggersReactLoop;
+        this.sideChannel = normalized.isSideChannel;
+        this.tapeHidden = normalized.tapeHidden;
+        this.question = normalized.question;
+        this.effect = normalized.effect;
+        this.caption = normalized.caption;
+        this.exam = normalized.type === "function" ? normalized.exam : undefined;
+    }
+    /** Host side channel. Skips the license floor. */
+    get isSideChannel() {
+        return this.sideChannel;
+    }
+    /** Normalized ABI record for load-boundary comparisons. */
+    toToolDefinition() {
+        const face = {
+            question: this.question,
+            effect: this.effect,
+            caption: this.caption,
+        };
+        if (this.type === "bot-call") {
+            return {
+                type: "bot-call",
+                name: this.name,
+                description: this.description,
+                class: this.class,
+                representation: this.representation,
+                input: this.input,
+                output: this.output,
+                target: this.target,
+                prepare: this.prepare,
+                background: this.background,
+                lifetime: this.lifetime,
+                show: this.show,
+                deadlineMs: this.deadlineMs,
+                maxResultTokens: this.maxResultTokens,
+                supportsNotify: this.supportsNotify,
+                triggersReactLoop: this.triggersReactLoop,
+                isSideChannel: this.isSideChannel,
+                tapeHidden: this.tapeHidden,
+                ...face,
+            };
+        }
+        return {
+            type: "function",
+            name: this.name,
+            description: this.description,
+            class: this.class,
+            representation: this.representation,
+            input: this.input,
+            output: this.output,
+            run: this._run,
+            triggersReactLoop: this.triggersReactLoop,
+            isSideChannel: this.isSideChannel,
+            tapeHidden: this.tapeHidden,
+            exam: this.exam,
+            ...face,
+        };
+    }
+    /** Parse raw args → run → parse output. Host admit path uses this. */
+    async execute(raw, ctx = {}) {
+        if (this.type === "bot-call") {
+            throw new TypeError(`InhumanTool(${this.name}): bot-call tools do not execute through run`);
+        }
+        if (this.exam != null && this._run == null) {
+            throw new TypeError(`InhumanTool(${this.name}): exam tools do not execute through run`);
+        }
+        const parsedCtx = inhumanShape.toolContext.parse(ctx);
+        if ((this.class === "read" || this.class === "write") && (parsedCtx.root == null || parsedCtx.root === "")) {
+            throw new TypeError(`InhumanTool(${this.name}): ctx.root string required for class ${this.class}`);
+        }
+        const input = this.input.parse(raw);
+        const out = await this._run(input, parsedCtx);
+        return this.output.parse(out);
+    }
+}
+export function defineTool(def) {
+    return new InhumanTool(def);
+}
+const actionBrand = inhumanBrand.action;
+export class InhumanAction {
+    [actionBrand] = true;
+    name;
+    description;
+    seat;
+    input;
+    run;
+    constructor(def) {
+        const parsed = inhumanShape.normalizedActionDef.parse(def);
+        this.name = parsed.name;
+        this.description = parsed.description;
+        this.seat = parsed.seat;
+        this.input = parsed.input;
+        this.run = parsed.run;
+    }
+}
+export function defineAction(def) {
+    return new InhumanAction(def);
+}
+const pluginBrand = inhumanBrand.plugin;
+export class InhumanPlugin {
+    [pluginBrand] = true;
+    apiVersion;
+    tools;
+    actions;
+    envCapabilities;
+    bots;
+    mcpServers;
+    exclusiveSlots;
+    projection;
+    definition;
+    constructor(def = {}) {
+        this.definition = resolveReferences(normalizeDefinitions(def, "InhumanPlugin"), "InhumanPlugin");
+        this.apiVersion = this.definition.apiVersion;
+        this.tools = Object.freeze(this.definition.tools.map((tool) => new InhumanTool(tool)));
+        this.actions = Object.freeze(this.definition.actions.map((action) => new InhumanAction(action)));
+        this.envCapabilities = Object.freeze([...this.definition.envCapabilities]);
+        this.bots = Object.freeze([...this.definition.bots]);
+        this.mcpServers = Object.freeze([...this.definition.mcpServers]);
+        this.exclusiveSlots = Object.freeze([...this.definition.exclusiveSlots]);
+        this.projection = this.definition.projection;
+    }
+    static isInhumanPlugin(value) {
+        return typeof value === "object" && value !== null && value[pluginBrand] === true;
+    }
+}
+export { z as z } from "zod";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/normalize.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Load-boundary normalize for plugin ABI v1. Produces plain records; branding
+ * and instanceof are not part of the contract.
+ */
+import type { EnvCapability } from "@here.build/arrival";
+import type { SystemPrompt } from "@inhuman.tools/harness-commons";
+import { ZodType } from "zod";
+import type { ExamAdmit, PluginProjection, PluginStorageHandles } from "./projection.js";
+import { REASONING_EFFORTS, type ToolRepresentation, NormalizedActionDefinition } from "./schemas/plugin.js";
+export type PluginCallContext = {
+    readonly root?: string;
+    readonly turn?: unknown;
+    readonly completion?: unknown | null;
+    readonly invocation?: unknown;
+    readonly signal?: AbortSignal;
+    /** Prefix projection for this plugin. Tool body proposes metadata via `propose`. */
+    readonly storage?: PluginStorageHandles;
+    readonly [key: string]: unknown;
+};
+export type BotMcpBinding = {
+    readonly server: string;
+    readonly tools: readonly string[];
+    readonly approval?: "allow" | "policy";
+};
+export type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
+export declare function isReasoningEffort(value: unknown): value is ReasoningEffort;
+export type BotDefinition = {
+    readonly name: string;
+    readonly recipeScope: "invocation" | "session" | "workspace" | "global";
+    readonly instructions: SystemPrompt;
+    /** Parent-facing one-liner. Inventory speech. */
+    readonly description?: string;
+    readonly tools?: readonly string[];
+    readonly mcp?: readonly BotMcpBinding[];
+    readonly keepAlive?: boolean;
+    /** Other bot names this concept may invoke. Same-plugin, resolved at load. */
+    readonly invokes?: readonly string[];
+    readonly reasoningEffort?: ReasoningEffort;
+    /** Ordered try-list of catalog model ids. Applied at mint when a resolver exists. */
+    readonly modelPreferences?: readonly string[];
+    readonly skills?: readonly string[];
+};
+export type McpServerDefinition = {
+    readonly name: string;
+    readonly visibility: "private" | "public";
+    readonly scope: "session" | "workspace" | "global";
+    readonly transport: {
+        readonly type: "stdio";
+        readonly command: string;
+        readonly args: readonly string[];
+        readonly cwd: "plugin" | "workspace";
+        readonly env?: Record<string, string> | ((ctx: {
+            readonly pluginRoot: string;
+            readonly workspaceRoot: string;
+        }) => Record<string, string>);
+    };
+};
+export type FunctionToolDefinition<I = unknown, O = unknown> = {
+    readonly type: "function";
+    readonly name: string;
+    readonly description?: string;
+    readonly class?: string;
+    readonly representation: ToolRepresentation;
+    readonly input: ZodType<I>;
+    readonly output: ZodType<O>;
+    readonly run: (input: I, ctx: PluginCallContext) => O | Promise<O>;
+    readonly triggersReactLoop: boolean;
+    readonly isSideChannel: boolean;
+    readonly tapeHidden: boolean;
+    readonly question: string | null;
+    readonly effect: string | null;
+    readonly caption: string | null;
+    readonly exam?: ExamAdmit<I, unknown, unknown>;
+};
+export type BotCallToolDefinition<I = unknown, O = unknown> = {
+    readonly type: "bot-call";
+    readonly name: string;
+    readonly description?: string;
+    readonly class?: string;
+    readonly representation: ToolRepresentation;
+    readonly input: ZodType<I>;
+    readonly output: ZodType<O>;
+    readonly target: string;
+    readonly prepare?: (input: I, ctx: PluginCallContext) => unknown;
+    readonly background?: boolean;
+    readonly lifetime?: "turn" | "call";
+    readonly show?: "result" | "omit" | "turn";
+    readonly deadlineMs?: number;
+    readonly maxResultTokens?: number;
+    readonly supportsNotify?: boolean;
+    readonly triggersReactLoop: boolean;
+    readonly isSideChannel: boolean;
+    readonly tapeHidden: boolean;
+    readonly question: string | null;
+    readonly effect: string | null;
+    readonly caption: string | null;
+};
+export type ToolDefinition<I = unknown, O = unknown> = FunctionToolDefinition<I, O> | BotCallToolDefinition<I, O>;
+export type NormalizedPluginDefinition = {
+    readonly apiVersion: 1;
+    readonly tools: readonly ToolDefinition[];
+    readonly bots: readonly BotDefinition[];
+    readonly mcpServers: readonly McpServerDefinition[];
+    readonly actions: readonly NormalizedActionDefinition[];
+    readonly envCapabilities: readonly EnvCapability[];
+    readonly exclusiveSlots: readonly string[];
+    readonly projection?: PluginProjection<any, any>;
+};
+export declare function validateSupportedVersion(bag: Record<string, unknown>, pluginName?: string): void;
+export declare function normalizeDefinitions(exported: unknown, pluginName?: string): NormalizedPluginDefinition;
+export declare function resolveReferences(definition: NormalizedPluginDefinition, pluginName?: string): NormalizedPluginDefinition;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

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