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

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

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

package/dist/schemas/plugin.js

@@ -0,0 +1,242 @@
+import { asSystemPrompt } from "@inhuman.tools/harness-commons";
+import { z } from "zod";
+export const inhumanBrand = {
+    tool: Symbol.for("@inhuman.tools/InhumanTool"),
+    action: Symbol.for("@inhuman.tools/InhumanAction"),
+    plugin: Symbol.for("@inhuman.tools/InhumanPlugin"),
+};
+const zodType = z.custom((value) => value != null && typeof value.parse === "function", { message: "zod schema required" });
+const fn = z.custom((value) => typeof value === "function", {
+    message: "JS function required",
+});
+/** `tool` is completions tools[]. `symbol` is a scheme_repl name. `both` is both. */
+export const toolRepresentation = z.enum(["tool", "symbol", "both"]);
+const tapeFace = z.string().trim().min(1, "tape face must be a non-empty string").nullable().default(null);
+const toolBase = {
+    name: z.string().trim().min(1, "InhumanTool: non-empty name required"),
+    description: z.string().optional(),
+    class: z.string().optional(),
+    /** Omitted function tools are symbols. Omitted bot-calls are tools. */
+    representation: toolRepresentation.optional(),
+    input: zodType,
+    output: zodType,
+    triggersReactLoop: z.boolean().optional(),
+    isSideChannel: z.boolean().optional(),
+    tapeHidden: z.boolean().optional(),
+    question: tapeFace,
+    effect: tapeFace,
+    caption: tapeFace,
+    exam: z
+        .object({
+        program: fn,
+        admit: fn,
+        settle: fn.optional(),
+        prefixAsk: fn.optional(),
+        finish: fn.optional(),
+    })
+        .optional(),
+};
+export const functionToolDef = z
+    .object({
+    ...toolBase,
+    type: z.literal("function").optional(),
+    run: fn.optional(),
+})
+    .superRefine((row, ctx) => {
+    if (row.exam == null && row.run == null) {
+        ctx.addIssue({ code: "custom", message: "function requires run" });
+    }
+});
+function catalogShow(raw) {
+    if (raw === "silent" || raw === "omit")
+        return "omit";
+    if (raw === "turn")
+        return "turn";
+    return "result";
+}
+function catalogLifetime(raw) {
+    if (raw === "call")
+        return "call";
+    return "turn";
+}
+export const botCallToolDef = z
+    .object({
+    ...toolBase,
+    type: z.literal("bot-call"),
+    target: z.string().trim().min(1, "bot-call target required"),
+    prepare: fn.optional(),
+    background: z.boolean().optional(),
+    lifetime: z.enum(["turn", "call"]).optional(),
+    show: z.enum(["result", "omit", "turn", "silent"]).optional(),
+    delivery: z.enum(["result", "silent", "turn"]).optional(),
+    deadlineMs: z.number().optional(),
+    maxResultTokens: z.number().optional(),
+    supportsNotify: z.boolean().optional(),
+})
+    .superRefine((row, ctx) => {
+    const raw = row.show ?? row.delivery;
+    if (raw === "turn" && (row.background !== true || !(row.deadlineMs != null && row.deadlineMs > 0))) {
+        ctx.addIssue({ code: "custom", message: "show turn requires background and positive deadlineMs" });
+    }
+})
+    .transform((row) => {
+    const { delivery: _delivery, show: rawShow, lifetime: rawLifetime, ...rest } = row;
+    return {
+        ...rest,
+        show: catalogShow(rawShow ?? _delivery),
+        lifetime: catalogLifetime(rawLifetime),
+    };
+});
+export const toolDef = z.union([functionToolDef, botCallToolDef]);
+export const normalizedActionDef = z.object({
+    name: z.string().trim().min(1, "InhumanAction: non-empty name required"),
+    description: z.string().optional(),
+    seat: z.enum(["session", "harness"]).default("session"),
+    input: zodType.optional(),
+    run: fn,
+});
+export const actionDef = normalizedActionDef;
+const brandedTool = z.custom((value) => typeof value === "object" && value !== null && value[inhumanBrand.tool] === true, { message: "must be InhumanTool" });
+const plainTool = z.union([functionToolDef, botCallToolDef]);
+const brandedAction = z.custom((value) => typeof value === "object" && value !== null && value[inhumanBrand.action] === true, { message: "must be InhumanAction" });
+const plainAction = normalizedActionDef;
+export const envCapability = z.custom((value) => typeof value === "object" &&
+    value !== null &&
+    typeof value.name === "string" &&
+    typeof value.exports === "function", { message: "must be Arrival EnvCapability" });
+export const REASONING_EFFORTS = ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+const nonempty = z.string().trim().min(1);
+export const botMcpBindingDef = z
+    .object({
+    server: nonempty,
+    tools: z.array(nonempty).default([]),
+    approval: z.enum(["allow", "policy"]).optional(),
+})
+    .transform((row) => ({
+    server: row.server,
+    tools: row.tools,
+    approval: row.approval === "allow" ? "allow" : "policy",
+}));
+export const botDef = z.preprocess((value) => {
+    if (value == null || typeof value !== "object" || Array.isArray(value))
+        return value;
+    const rec = { ...value };
+    if (rec.recipeScope === undefined && "scope" in rec)
+        rec.recipeScope = rec.scope;
+    delete rec.scope;
+    return rec;
+}, z
+    .object({
+    name: nonempty,
+    recipeScope: z.enum(["invocation", "session", "workspace", "global"]),
+    instructions: nonempty,
+    description: z.string().trim().optional(),
+    tools: z.array(nonempty).default([]),
+    mcp: z.array(botMcpBindingDef).default([]),
+    keepAlive: z.boolean().optional(),
+    invokes: z.array(nonempty).default([]),
+    reasoningEffort: z.enum(REASONING_EFFORTS).optional(),
+    modelPreferences: z.array(nonempty).default([]),
+    skills: z.array(nonempty).default([]),
+})
+    .transform((row) => ({
+    name: row.name,
+    recipeScope: row.recipeScope,
+    instructions: asSystemPrompt(row.instructions),
+    ...(row.description === undefined || row.description === "" ? {} : { description: row.description }),
+    tools: row.tools,
+    mcp: row.mcp,
+    keepAlive: row.keepAlive === true,
+    invokes: row.invokes,
+    ...(row.reasoningEffort === undefined ? {} : { reasoningEffort: row.reasoningEffort }),
+    modelPreferences: row.modelPreferences,
+    skills: row.skills,
+})));
+export const mcpServerDef = z.object({
+    name: nonempty,
+    visibility: z.enum(["private", "public"]),
+    scope: z.enum(["session", "workspace", "global"]),
+    transport: z.object({
+        type: z.literal("stdio"),
+        command: nonempty,
+        args: z.array(z.string()).default([]),
+        cwd: z.enum(["plugin", "workspace"]),
+        env: z
+            .union([
+            z.record(z.string(), z.string()),
+            z.custom((value) => typeof value === "function", { message: "JS function required" }),
+        ])
+            .optional(),
+    }),
+});
+export const pluginProjectionDef = z.object({
+    initial: z.custom((value) => typeof value === "function", { message: "JS function required" }),
+    reduce: z.custom((value) => typeof value === "function", {
+        message: "JS function required",
+    }),
+    hostOnly: z
+        .custom((value) => typeof value === "function", { message: "JS function required" })
+        .optional(),
+});
+export const exclusiveSlotsDef = z.array(nonempty);
+export const pluginDef = z
+    .object({
+    apiVersion: z.literal(1).optional(),
+    tools: z.array(z.union([brandedTool, plainTool])).default([]),
+    actions: z.array(z.union([brandedAction, plainAction])).default([]),
+    envCapabilities: z.array(envCapability).default([]),
+    bots: z.array(botDef).default([]),
+    mcpServers: z.array(mcpServerDef).default([]),
+    exclusiveSlots: exclusiveSlotsDef.default([]),
+    projection: pluginProjectionDef.optional(),
+})
+    .superRefine((bag, ctx) => {
+    const seen = new Set();
+    for (const [index, action] of bag.actions.entries()) {
+        const name = typeof action === "object" && action !== null && "name" in action
+            ? String(action.name ?? "")
+            : "";
+        if (seen.has(name)) {
+            ctx.addIssue({
+                code: "custom",
+                message: `action "${name}" collides`,
+                path: ["actions", index],
+            });
+        }
+        seen.add(name);
+    }
+});
+export const toolContext = z
+    .object({
+    root: z.string().optional(),
+    signal: z.custom((value) => value instanceof AbortSignal).optional(),
+    turn: z.unknown().optional(),
+    completion: z.unknown().nullable().optional(),
+    invocation: z.unknown().optional(),
+    storage: z
+        .object({
+        session: z.unknown(),
+        invocation: z.unknown(),
+        project: z.unknown().optional(),
+        global: z.unknown().optional(),
+        propose: fn,
+    })
+        .optional(),
+})
+    .passthrough();
+export const inhumanShape = {
+    toolDef,
+    functionToolDef,
+    botCallToolDef,
+    actionDef,
+    normalizedActionDef,
+    pluginDef,
+    botDef,
+    botMcpBindingDef,
+    mcpServerDef,
+    pluginProjectionDef,
+    exclusiveSlotsDef,
+    toolContext,
+    envCapability,
+};
+//# sourceMappingURL=plugin.js.map

package/dist/schemas/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/schemas/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC;CAC1C,CAAC;AAEX,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,EACtF,EAAE,OAAO,EAAE,qBAAqB,EAAE,CACnC,CAAC;AAEF,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAgC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,EAAE;IACzF,OAAO,EAAE,sBAAsB;CAChC,CAAC,CAAC;AAEH,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAGrE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3G,MAAM,QAAQ,GAAG;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;IACtE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,uEAAuE;IACvE,cAAc,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAC7C,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;IACf,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE;QACrB,SAAS,EAAE,EAAE,CAAC,QAAQ,EAAE;QACxB,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE;KACtB,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,GAAG,QAAQ;IACX,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACtC,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE;CACnB,CAAC;KACD,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;QACxC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,SAAS,WAAW,CAAC,GAAuB;IAC1C,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACtD,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,GAAuB;IAC9C,IAAI,GAAG,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,GAAG,QAAQ;IACX,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAC5D,OAAO,EAAE,EAAE,CAAC,QAAQ,EAAE;IACtB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IACrC,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACnG,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uDAAuD,EAAE,CAAC,CAAC;IACrG,CAAC;AACH,CAAC,CAAC;KACD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;IACnF,OAAO;QACL,GAAG,IAAI;QACP,IAAI,EAAE,WAAW,CAAC,OAAO,IAAI,SAAS,CAAC;QACvC,QAAQ,EAAE,eAAe,CAAC,WAAW,CAAC;KACvC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wCAAwC,CAAC;IACxE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACvD,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE;IACzB,GAAG,EAAE,EAAE;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAE7C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAC1B,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAkC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,EAChH,EAAE,OAAO,EAAE,qBAAqB,EAAE,CACnC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;AAE7D,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAC5B,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAkC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,IAAI,EAClH,EAAE,OAAO,EAAE,uBAAuB,EAAE,CACrC,CAAC;AAEF,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;IACtD,OAAQ,KAA+B,CAAC,OAAO,KAAK,UAAU,EAChE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAC7C,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAU,CAAC;AAEvG,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC;KACD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnB,MAAM,EAAE,GAAG,CAAC,MAAM;IAClB,KAAK,EAAE,GAAG,CAAC,KAAK;IAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,QAAkB;CAC9E,CAAC,CAAC,CAAC;AAEN,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAChC,CAAC,KAAK,EAAE,EAAE;IACR,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrF,MAAM,GAAG,GAAG,EAAE,GAAI,KAAiC,EAAE,CAAC;IACtD,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,IAAI,GAAG;QAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC;IACjF,OAAO,GAAG,CAAC,KAAK,CAAC;IACjB,OAAO,GAAG,CAAC;AACb,CAAC,EACD,CAAC;KACE,MAAM,CAAC;IACN,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACrE,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IACrD,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC;KACD,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC,IAAI;IACd,WAAW,EAAE,GAAG,CAAC,WAAW;IAC5B,YAAY,EAAE,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC;IAC9C,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;IACpG,KAAK,EAAE,GAAG,CAAC,KAAK;IAChB,GAAG,EAAE,GAAG,CAAC,GAAG;IACZ,SAAS,EAAE,GAAG,CAAC,SAAS,KAAK,IAAI;IACjC,OAAO,EAAE,GAAG,CAAC,OAAO;IACpB,GAAG,CAAC,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC;IACtF,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;IACtC,MAAM,EAAE,GAAG,CAAC,MAAM;CACnB,CAAC,CAAC,CACN,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpC,GAAG,EAAE,CAAC;aACH,KAAK,CAAC;YACL,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;YAChC,CAAC,CAAC,MAAM,CACN,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,EACtC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CACpC;SACF,CAAC;aACD,QAAQ,EAAE;KACd,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAC7G,MAAM,EAAE,CAAC,CAAC,MAAM,CAA+C,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,EAAE;QACrG,OAAO,EAAE,sBAAsB;KAChC,CAAC;IACF,QAAQ,EAAE,CAAC;SACR,MAAM,CAA+B,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;SACjH,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnE,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7C,cAAc,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7C,UAAU,EAAE,mBAAmB,CAAC,QAAQ,EAAE;CAC3C,CAAC;KACD,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM;YAC/D,CAAC,CAAC,MAAM,CAAE,MAA6B,CAAC,IAAI,IAAI,EAAE,CAAC;YACnD,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,WAAW,IAAI,YAAY;gBACpC,IAAI,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC;aACzB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAc,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,WAAW,CAAC,CAAC,QAAQ,EAAE;IACjF,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;QACvB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC9B,OAAO,EAAE,EAAE;KACZ,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAIjB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO;IACP,eAAe;IACf,cAAc;IACd,SAAS;IACT,mBAAmB;IACnB,SAAS;IACT,MAAM;IACN,gBAAgB;IAChB,YAAY;IACZ,mBAAmB;IACnB,iBAAiB;IACjB,WAAW;IACX,aAAa;CACL,CAAC"}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@inhuman.tools/plugin-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "InhumanPlugin barrel — tools, actions, optional EnvCapability.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/__tests__"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@inhuman.tools/harness-commons": "^0.2.0"
+  },
+  "peerDependencies": {
+    "@here.build/arrival": "^0.10.2"
+  },
+  "peerDependenciesMeta": {
+    "@here.build/arrival": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "eslint": "9.39.2",
+    "@types/node": "^24.0.0",
+    "typescript": "6.0.2",
+    "vitest": "4.1.0",
+    "@-internal-/eslint-configs": "0.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/here-build/inhuman-harness.git",
+    "directory": "packages/harness-plugin-sdk"
+  },
+  "browserslist": [
+    "last 2 chrome versions",
+    "last 2 firefox versions",
+    "last 2 safari versions",
+    "ios_saf >= 16.4",
+    "node >= 22"
+  ],
+  "author": "Merkle Bonsai",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/src/index.ts

@@ -0,0 +1,320 @@
+/**
+ * @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 {
+  normalizeDefinitions,
+  resolveReferences,
+  type BotDefinition,
+  type McpServerDefinition,
+  type NormalizedPluginDefinition,
+  type PluginCallContext,
+  type ToolDefinition,
+} from "./normalize.js";
+import { type ExamAdmit, type PluginProjection } from "./projection.js";
+import { inhumanBrand, inhumanShape, 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 class InhumanTool<TIn = unknown, TOut = unknown> {
+  readonly [inhumanBrand.tool] = true as const;
+
+  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: boolean;
+  readonly question: string | null;
+  readonly effect: string | null;
+  readonly caption: string | null;
+  readonly exam?: ExamAdmit<TIn, unknown, unknown>;
+  private readonly _run?: (input: TIn, ctx: ToolContext) => Promise<TOut> | TOut;
+
+  constructor(def: InhumanToolDef<TIn, TOut>) {
+    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 as z.ZodType<TIn>;
+    this.output = normalized.output as z.ZodType<TOut>;
+    this.type = normalized.type;
+    if (normalized.type === "function") {
+      this._run = normalized.run as (input: TIn, ctx: ToolContext) => Promise<TOut> | TOut;
+    } else {
+      this.target = normalized.target;
+      this.prepare = normalized.prepare as (input: TIn, ctx: ToolContext) => unknown;
+      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(): boolean {
+    return this.sideChannel;
+  }
+
+  /** Normalized ABI record for load-boundary comparisons. */
+  toToolDefinition(): ToolDefinition<TIn, TOut> {
+    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: unknown, ctx: ToolContext = {}): Promise<TOut> {
+    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 as ToolContext);
+    return this.output.parse(out);
+  }
+}
+
+export function defineTool<TIn, TOut>(def: InhumanToolDef<TIn, TOut>): InhumanTool<TIn, TOut> {
+  return new InhumanTool(def);
+}
+
+/** 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";
+
+const actionBrand = inhumanBrand.action;
+
+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 class InhumanAction<TArgs = unknown, TOut = unknown> {
+  readonly [actionBrand] = true as const;
+
+  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>) {
+    const parsed = inhumanShape.normalizedActionDef.parse(def);
+    this.name = parsed.name;
+    this.description = parsed.description;
+    this.seat = parsed.seat;
+    this.input = parsed.input as z.ZodType<TArgs> | undefined;
+    this.run = parsed.run as ActionFn<TArgs, TOut>;
+  }
+}
+
+export function defineAction<TArgs, TOut>(def: InhumanActionDef<TArgs, TOut>): InhumanAction<TArgs, TOut> {
+  return new InhumanAction(def);
+}
+
+/** 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>;
+};
+
+const pluginBrand = inhumanBrand.plugin;
+
+export class InhumanPlugin {
+  readonly [pluginBrand] = true as const;
+
+  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 = {}) {
+    this.definition = resolveReferences(normalizeDefinitions(def, "InhumanPlugin"), "InhumanPlugin");
+    this.apiVersion = this.definition.apiVersion;
+    this.tools = Object.freeze(
+      this.definition.tools.map((tool) => new InhumanTool(tool as InhumanToolDef<unknown, unknown>)),
+    ) as readonly InhumanTool[];
+    this.actions = Object.freeze(
+      this.definition.actions.map((action) => new InhumanAction(action as InhumanActionDef)),
+    ) as readonly InhumanAction[];
+    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: unknown): value is InhumanPlugin {
+    return typeof value === "object" && value !== null && (value as { [pluginBrand]?: boolean })[pluginBrand] === true;
+  }
+}
+
+export { z as z } from "zod";