@gencode/agents 0.0.1

package/dist/plugins/manifest.js

@@ -0,0 +1,80 @@
+import fs from "node:fs";
+import path from "node:path";
+import { openBoundaryFileSync } from "./boundary-file-read.js";
+import { isRecord, normalizeStringList } from "./utils.js";
+export const PLUGIN_MANIFEST_FILENAME = "aimax.plugin.json";
+export const PLUGIN_MANIFEST_FILENAMES = [PLUGIN_MANIFEST_FILENAME];
+export function resolvePluginManifestPath(rootDir) {
+    for (const filename of PLUGIN_MANIFEST_FILENAMES) {
+        const candidate = path.join(rootDir, filename);
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return path.join(rootDir, PLUGIN_MANIFEST_FILENAME);
+}
+export function loadPluginManifest(rootDir, rejectHardlinks = true) {
+    const manifestPath = resolvePluginManifestPath(rootDir);
+    const opened = openBoundaryFileSync({
+        absolutePath: manifestPath,
+        rootPath: rootDir,
+        rejectHardlinks,
+    });
+    if (!opened.ok) {
+        const reason = opened.reason;
+        if (reason === "path") {
+            return { ok: false, error: `plugin manifest not found: ${manifestPath}`, manifestPath };
+        }
+        return {
+            ok: false,
+            error: `unsafe plugin manifest path: ${manifestPath} (${reason})`,
+            manifestPath,
+        };
+    }
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(opened.fd, "utf-8"));
+    }
+    catch (err) {
+        return {
+            ok: false,
+            error: `failed to parse plugin manifest: ${String(err)}`,
+            manifestPath,
+        };
+    }
+    finally {
+        fs.closeSync(opened.fd);
+    }
+    if (!isRecord(raw)) {
+        return { ok: false, error: "plugin manifest must be an object", manifestPath };
+    }
+    const id = typeof raw.id === "string" ? raw.id.trim() : "";
+    if (!id) {
+        return { ok: false, error: "plugin manifest requires id", manifestPath };
+    }
+    const configSchema = isRecord(raw.configSchema) ? raw.configSchema : null;
+    if (!configSchema) {
+        return { ok: false, error: "plugin manifest requires configSchema", manifestPath };
+    }
+    const kind = typeof raw.kind === "string" ? raw.kind : undefined;
+    const name = typeof raw.name === "string" ? raw.name.trim() : undefined;
+    const description = typeof raw.description === "string" ? raw.description.trim() : undefined;
+    const version = typeof raw.version === "string" ? raw.version.trim() : undefined;
+    const skills = normalizeStringList(raw.skills);
+    let uiHints;
+    if (isRecord(raw.uiHints)) {
+        uiHints = raw.uiHints;
+    }
+    const manifest = {
+        id,
+        configSchema,
+        kind,
+        name,
+        description,
+        version,
+        skills,
+        uiHints,
+    };
+    return { ok: true, manifest, manifestPath };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/manifest.js.map

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

package/dist/plugins/path-safety.d.ts

@@ -0,0 +1,6 @@
+import fs from "node:fs";
+export declare function safeRealpathSync(target: string): string | null;
+export declare function safeStatSync(target: string): fs.Stats | null;
+export declare function isPathInside(rootPath: string, targetPath: string): boolean;
+export declare function formatPosixMode(modeBits: number): string;
+//# sourceMappingURL=path-safety.d.ts.map

package/dist/plugins/path-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.d.ts","sourceRoot":"","sources":["../../src/plugins/path-safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM9D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK,GAAG,IAAI,CAM5D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAS1E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/plugins/path-safety.js

@@ -0,0 +1,32 @@
+import fs from "node:fs";
+import path from "node:path";
+export function safeRealpathSync(target) {
+    try {
+        return fs.realpathSync(target);
+    }
+    catch {
+        return null;
+    }
+}
+export function safeStatSync(target) {
+    try {
+        return fs.statSync(target);
+    }
+    catch {
+        return null;
+    }
+}
+export function isPathInside(rootPath, targetPath) {
+    const relative = path.relative(rootPath, targetPath);
+    if (relative === "") {
+        return true;
+    }
+    if (relative.startsWith("..")) {
+        return false;
+    }
+    return !path.isAbsolute(relative);
+}
+export function formatPosixMode(modeBits) {
+    return `0o${modeBits.toString(8).padStart(3, "0")}`;
+}
+//# sourceMappingURL=path-safety.js.map

package/dist/plugins/path-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-safety.js","sourceRoot":"","sources":["../../src/plugins/path-safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,UAAkB;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/plugins/runtime-context.d.ts

@@ -0,0 +1,12 @@
+import type { PluginHookAgentContext } from "./hooks.js";
+export type PluginRuntimeContext = {
+    llm?: {
+        baseUrl: string;
+        apiKey: string;
+        model: string;
+        contextWindow?: number;
+    };
+    hookCtx?: PluginHookAgentContext;
+    llmAllowlist?: string[];
+};
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/plugins/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../../src/plugins/runtime-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,CAAC,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC"}

package/dist/plugins/runtime-context.js

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

package/dist/plugins/runtime-context.js.map

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

package/dist/plugins/runtime.d.ts

@@ -0,0 +1,12 @@
+export type PluginRuntime = {
+    version: string;
+    logging: {
+        getLogger: (name: string) => {
+            info: (message: string) => void;
+            warn: (message: string) => void;
+            error: (message: string) => void;
+        };
+    };
+};
+export declare function createPluginRuntime(): PluginRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/plugins/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/plugins/runtime.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;YAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;YAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;YAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;SAClC,CAAC;KACH,CAAC;CACH,CAAC;AAEF,wBAAgB,mBAAmB,IAAI,aAAa,CAWnD"}

package/dist/plugins/runtime.js

@@ -0,0 +1,13 @@
+export function createPluginRuntime() {
+    return {
+        version: "0.1.0",
+        logging: {
+            getLogger: (name) => ({
+                info: (message) => console.log(`[plugin:${name}] ${message}`),
+                warn: (message) => console.warn(`[plugin:${name}] ${message}`),
+                error: (message) => console.error(`[plugin:${name}] ${message}`),
+            }),
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/plugins/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/plugins/runtime.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE;YACP,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,KAAK,OAAO,EAAE,CAAC;gBACrE,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,KAAK,OAAO,EAAE,CAAC;gBACtE,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,OAAO,EAAE,CAAC;aACzE,CAAC;SACH;KACF,CAAC;AACJ,CAAC"}

package/dist/plugins/schema-validator.d.ts

@@ -0,0 +1,17 @@
+type ValidationError = {
+    path: string;
+    message: string;
+};
+type ValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: ValidationError[];
+};
+export declare function validateJsonSchemaValue(params: {
+    schema: Record<string, unknown>;
+    cacheKey?: string;
+    value: unknown;
+}): ValidationResult;
+export {};
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/plugins/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/plugins/schema-validator.ts"],"names":[],"mappings":"AAEA,KAAK,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,KAAK,gBAAgB,GACjB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AAgB7C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,gBAAgB,CAYnB"}

package/dist/plugins/schema-validator.js

@@ -0,0 +1,26 @@
+import Ajv from "ajv";
+const ajv = new Ajv({ allErrors: true, strict: false });
+const schemaCache = new Map();
+function compileSchema(schema, cacheKey) {
+    const cached = schemaCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const compiled = ajv.compile(schema);
+    schemaCache.set(cacheKey, compiled);
+    return compiled;
+}
+export function validateJsonSchemaValue(params) {
+    const cacheKey = params.cacheKey ?? JSON.stringify(params.schema);
+    const validate = compileSchema(params.schema, cacheKey);
+    const ok = validate(params.value);
+    if (ok) {
+        return { ok: true };
+    }
+    const errors = (validate.errors ?? []).map((error) => ({
+        path: error.instancePath || "/",
+        message: error.message ?? "invalid",
+    }));
+    return { ok: false, errors };
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/plugins/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../src/plugins/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAQtB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAExD,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0C,CAAC;AAEtE,SAAS,aAAa,CAAC,MAA+B,EAAE,QAAgB;IACtE,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAIvC;IACC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,EAAE,EAAE,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,KAAK,CAAC,YAAY,IAAI,GAAG;QAC/B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,SAAS;KACpC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/plugins/tool-hooks.d.ts

@@ -0,0 +1,4 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { PluginHookRegistry, PluginHookAgentContext } from "./hooks.js";
+export declare function wrapToolsWithHooks(tools: AgentTool[], hooks: PluginHookRegistry, ctx: PluginHookAgentContext): AgentTool[];
+//# sourceMappingURL=tool-hooks.d.ts.map

package/dist/plugins/tool-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-hooks.d.ts","sourceRoot":"","sources":["../../src/plugins/tool-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,sBAAsB,GAC1B,SAAS,EAAE,CAkFb"}

package/dist/plugins/tool-hooks.js

@@ -0,0 +1,60 @@
+export function wrapToolsWithHooks(tools, hooks, ctx) {
+    return tools.map((tool) => {
+        const original = tool;
+        const name = tool.name ?? "unknown";
+        return {
+            ...original,
+            async execute(toolCallId, args, signal, onUpdate) {
+                const start = Date.now();
+                let params = (args ?? {});
+                let blocked = false;
+                let blockReason;
+                const beforeResults = await hooks.dispatch("before_tool_call", { toolName: name, params }, ctx);
+                for (const result of beforeResults) {
+                    if (!result)
+                        continue;
+                    if (result.params) {
+                        params = result.params;
+                    }
+                    if (result.block) {
+                        blocked = true;
+                        blockReason = result.blockReason;
+                    }
+                }
+                if (blocked) {
+                    await hooks.dispatch("after_tool_call", {
+                        toolName: name,
+                        params,
+                        error: blockReason ?? "blocked by plugin",
+                        durationMs: Date.now() - start,
+                    }, ctx);
+                    return {
+                        content: [{ type: "text", text: blockReason ?? "Tool blocked by plugin" }],
+                        isError: true,
+                        details: {},
+                    };
+                }
+                try {
+                    const result = await original.execute(toolCallId, params, signal, onUpdate);
+                    await hooks.dispatch("after_tool_call", {
+                        toolName: name,
+                        params,
+                        result,
+                        durationMs: Date.now() - start,
+                    }, ctx);
+                    return result;
+                }
+                catch (err) {
+                    await hooks.dispatch("after_tool_call", {
+                        toolName: name,
+                        params,
+                        error: String(err),
+                        durationMs: Date.now() - start,
+                    }, ctx);
+                    throw err;
+                }
+            },
+        };
+    });
+}
+//# sourceMappingURL=tool-hooks.js.map

package/dist/plugins/tool-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-hooks.js","sourceRoot":"","sources":["../../src/plugins/tool-hooks.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,KAAyB,EACzB,GAA2B;IAE3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC;QACtB,MAAM,IAAI,GAAI,IAA0B,CAAC,IAAI,IAAI,SAAS,CAAC;QAE3D,OAAO;YACL,GAAG,QAAQ;YACX,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,IAAa,EACb,MAAoB,EACpB,QAA2C;gBAE3C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACzB,IAAI,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;gBACrD,IAAI,OAAO,GAAG,KAAK,CAAC;gBACpB,IAAI,WAA+B,CAAC;gBAEpC,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,QAAQ,CACxC,kBAAkB,EAClB,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAC1B,GAAG,CACJ,CAAC;gBAEF,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;oBACnC,IAAI,CAAC,MAAM;wBAAE,SAAS;oBACtB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;wBAClB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;oBACzB,CAAC;oBACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,OAAO,GAAG,IAAI,CAAC;wBACf,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;oBACnC,CAAC;gBACH,CAAC;gBAED,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,KAAK,CAAC,QAAQ,CAClB,iBAAiB,EACjB;wBACE,QAAQ,EAAE,IAAI;wBACd,MAAM;wBACN,KAAK,EAAE,WAAW,IAAI,mBAAmB;wBACzC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAC/B,EACD,GAAG,CACJ,CAAC;oBACF,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,IAAI,wBAAwB,EAAE,CAAC;wBAC1E,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,EAAE;qBACZ,CAAC;gBACJ,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,MAAa,EAAE,MAAM,EAAE,QAAe,CAAC,CAAC;oBAC1F,MAAM,KAAK,CAAC,QAAQ,CAClB,iBAAiB,EACjB;wBACE,QAAQ,EAAE,IAAI;wBACd,MAAM;wBACN,MAAM;wBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAC/B,EACD,GAAG,CACJ,CAAC;oBACF,OAAO,MAAM,CAAC;gBAChB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,KAAK,CAAC,QAAQ,CAClB,iBAAiB,EACjB;wBACE,QAAQ,EAAE,IAAI;wBACd,MAAM;wBACN,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;wBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAC/B,EACD,GAAG,CACJ,CAAC;oBACF,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;SACW,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/plugins/tools.d.ts

@@ -0,0 +1,20 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+export type PluginToolOptions = {
+    optional?: boolean;
+    name?: string;
+    names?: string[];
+};
+export type RegisteredPluginTool = {
+    pluginId: string;
+    tool: AgentTool;
+    optional: boolean;
+    names: string[];
+};
+export declare class PluginToolRegistry {
+    private readonly tools;
+    register(pluginId: string, tool: AgentTool, opts?: PluginToolOptions): void;
+    list(): RegisteredPluginTool[];
+    namesForPlugin(pluginId: string): string[];
+    resolveEnabled(allowlist?: string[]): AgentTool[];
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/plugins/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/plugins/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAEpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAW3E,IAAI,IAAI,oBAAoB,EAAE;IAI9B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAM1C,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE;CAoBlD"}

package/dist/plugins/tools.js

@@ -0,0 +1,42 @@
+export class PluginToolRegistry {
+    tools = [];
+    register(pluginId, tool, opts) {
+        const name = tool.name;
+        const names = opts?.names ?? (opts?.name ? [opts.name] : name ? [name] : []);
+        this.tools.push({
+            pluginId,
+            tool,
+            optional: opts?.optional ?? false,
+            names,
+        });
+    }
+    list() {
+        return [...this.tools];
+    }
+    namesForPlugin(pluginId) {
+        return this.tools
+            .filter((entry) => entry.pluginId === pluginId)
+            .flatMap((entry) => entry.names);
+    }
+    resolveEnabled(allowlist) {
+        const allow = new Set((allowlist ?? []).map((entry) => entry.trim()).filter(Boolean));
+        return this.tools.filter((entry) => {
+            if (!entry.optional) {
+                return true;
+            }
+            if (allow.size === 0) {
+                return false;
+            }
+            if (allow.has(entry.pluginId)) {
+                return true;
+            }
+            for (const name of entry.names) {
+                if (allow.has(name)) {
+                    return true;
+                }
+            }
+            return false;
+        }).map((entry) => entry.tool);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/plugins/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/plugins/tools.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,kBAAkB;IACZ,KAAK,GAA2B,EAAE,CAAC;IAEpD,QAAQ,CAAC,QAAgB,EAAE,IAAe,EAAE,IAAwB;QAClE,MAAM,IAAI,GAAI,IAA0B,CAAC,IAAI,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,QAAQ;YACR,IAAI;YACJ,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,KAAK;YACjC,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,cAAc,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;aAC9C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,cAAc,CAAC,SAAoB;QACjC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpB,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/plugins/types.d.ts

@@ -0,0 +1,61 @@
+export type PluginDiagnostic = {
+    level: "warn" | "error";
+    message: string;
+    pluginId?: string;
+    source?: string;
+};
+export type PluginOrigin = "bundled" | "global" | "workspace" | "config";
+export type PluginKind = "memory";
+export type PluginConfigUiHint = {
+    label?: string;
+    help?: string;
+    tags?: string[];
+    advanced?: boolean;
+    sensitive?: boolean;
+    placeholder?: string;
+};
+export type PluginManifest = {
+    id: string;
+    configSchema: Record<string, unknown>;
+    kind?: PluginKind;
+    skills?: string[];
+    name?: string;
+    description?: string;
+    version?: string;
+    uiHints?: Record<string, PluginConfigUiHint>;
+};
+export type PluginManifestLoadResult = {
+    ok: true;
+    manifest: PluginManifest;
+    manifestPath: string;
+} | {
+    ok: false;
+    error: string;
+    manifestPath: string;
+};
+export type PluginCandidate = {
+    idHint: string;
+    source: string;
+    rootDir: string;
+    origin: PluginOrigin;
+    workspaceDir?: string;
+    packageName?: string;
+    packageVersion?: string;
+    packageDescription?: string;
+    packageDir?: string;
+    packageManifest?: AIMaxPackageManifest;
+};
+export type AIMaxPackageManifest = {
+    extensions?: string[];
+};
+export type PackageManifest = {
+    name?: string;
+    version?: string;
+    description?: string;
+    aimax?: AIMaxPackageManifest;
+};
+export type PluginDiscoveryResult = {
+    candidates: PluginCandidate[];
+    diagnostics: PluginDiagnostic[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;AAElC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,oBAAoB,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC,CAAC"}

package/dist/plugins/types.js

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

package/dist/plugins/types.js.map

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

package/dist/plugins/utils.d.ts

@@ -0,0 +1,4 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function normalizeStringList(value: unknown): string[];
+export declare function resolveUserPath(input: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/plugins/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/plugins/utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAK5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASrD"}

package/dist/plugins/utils.js

@@ -0,0 +1,22 @@
+import os from "node:os";
+import path from "node:path";
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function normalizeStringList(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map((entry) => (typeof entry === "string" ? entry.trim() : "")).filter(Boolean);
+}
+export function resolveUserPath(input) {
+    const trimmed = input.trim();
+    if (trimmed === "~") {
+        return os.homedir();
+    }
+    if (trimmed.startsWith("~/") || trimmed.startsWith("~\\")) {
+        return path.join(os.homedir(), trimmed.slice(2));
+    }
+    return path.resolve(trimmed);
+}
+//# sourceMappingURL=utils.js.map

package/dist/plugins/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/plugins/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/runner/runner.d.ts

@@ -0,0 +1,14 @@
+import type { AgentRunParams, AgentRunResult } from "../types.js";
+import { SubagentRegistry } from "../subagent/registry.js";
+/** Generates a session title by truncating the first user message */
+export declare function generateSessionTitle(message: string, maxLength?: number): string;
+/**
+ * Runs an agent session end-to-end.
+ * Supports multi-agent: subagents spawned via sessions_spawn are automatically
+ * awaited and their results announced back to the parent agent.
+ *
+ * @param params - Run parameters.
+ * @param _registryForTesting - Internal: inject a pre-populated registry for unit tests.
+ */
+export declare function runAgent(params: AgentRunParams, _registryForTesting?: SubagentRegistry): Promise<AgentRunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAKf,MAAM,aAAa,CAAC;AASrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAqC3D,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAG5E;AA8lCD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,mBAAmB,CAAC,EAAE,gBAAgB,GACrC,OAAO,CAAC,cAAc,CAAC,CAGzB"}