@easynet/agent-tool 1.0.23 → 1.0.25

package/dist/api/extension/contextRunner.d.ts

@@ -0,0 +1,10 @@
+export interface ContextRunner<T> {
+    runWith(ctx: T, fn: () => Promise<unknown>): Promise<unknown>;
+    getContext(): T;
+}
+/**
+ * Create a context runner for an extension. Handlers call getContext() to read config.
+ * Adapter calls runWith(ctx, () => handler(args)) so getContext() returns ctx.
+ */
+export declare function createContextRunner<T>(): ContextRunner<T>;
+//# sourceMappingURL=contextRunner.d.ts.map

package/dist/api/extension/contextRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextRunner.d.ts","sourceRoot":"","sources":["../../../src/api/extension/contextRunner.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,UAAU,IAAI,CAAC,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAczD"}

package/dist/api/extension/createExtension.d.ts

@@ -0,0 +1,38 @@
+import type { ToolAdapter } from "../../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+import type { ExtensionToolContext } from "./types.js";
+/** Pass import.meta so the framework derives packagePath (extension entry does not need path/fileURLToPath). */
+export interface ImportMetaLike {
+    url: string;
+}
+/** Options when config is built from userConfig (buildConfig). */
+export interface CreateExtensionOptionsWithBuild<TConfig, TUserConfig> {
+    packagePath?: string;
+    importMeta?: ImportMetaLike;
+    kind?: string;
+    buildConfig: (userConfig: TUserConfig) => TConfig;
+}
+/** Options when config is per-tool only (each tool's tool.yaml). */
+export interface CreateExtensionOptionsDefaultOnly {
+    packagePath?: string;
+    importMeta?: ImportMetaLike;
+    kind?: string;
+}
+/** Register opts when using per-tool config only: filter tools by name. */
+export interface RegisterOptionsDefaultOnly {
+    only?: string[];
+    namePrefixes?: string[];
+}
+export type CreateExtensionOptions<TConfig, TUserConfig> = CreateExtensionOptionsWithBuild<TConfig, TUserConfig> | (CreateExtensionOptionsDefaultOnly & {
+    buildConfig?: never;
+});
+export interface CreateExtensionResult<TConfig, TUserConfig> {
+    register(registry: ToolRegistry, userConfigOrOpts: TUserConfig, options?: {
+        only?: string[];
+        namePrefixes?: string[];
+    }): ToolAdapter;
+    getContext(): ExtensionToolContext<TConfig>;
+    runWith<T>(ctx: ExtensionToolContext<TConfig>, fn: () => Promise<T>): Promise<T>;
+}
+export declare function createExtension<TConfig = Record<string, unknown>, TUserConfig = RegisterOptionsDefaultOnly>(options: CreateExtensionOptions<TConfig, TUserConfig>): CreateExtensionResult<TConfig, TUserConfig>;
+//# sourceMappingURL=createExtension.d.ts.map

package/dist/api/extension/createExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExtension.d.ts","sourceRoot":"","sources":["../../../src/api/extension/createExtension.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,gHAAgH;AAChH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kEAAkE;AAClE,MAAM,WAAW,+BAA+B,CAAC,OAAO,EAAE,WAAW;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,CAAC,UAAU,EAAE,WAAW,KAAK,OAAO,CAAC;CACnD;AAED,oEAAoE;AACpE,MAAM,WAAW,iCAAiC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,sBAAsB,CAAC,OAAO,EAAE,WAAW,IACnD,+BAA+B,CAAC,OAAO,EAAE,WAAW,CAAC,GACrD,CAAC,iCAAiC,GAAG;IAAE,WAAW,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AAElE,MAAM,WAAW,qBAAqB,CAAC,OAAO,EAAE,WAAW;IACzD,QAAQ,CACN,QAAQ,EAAE,YAAY,EACtB,gBAAgB,EAAE,WAAW,EAC7B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACrD,WAAW,CAAC;IACf,UAAU,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClF;AAYD,wBAAgB,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,0BAA0B,EACzG,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,WAAW,CAAC,GACpD,qBAAqB,CAAC,OAAO,EAAE,WAAW,CAAC,CA4B7C"}

package/dist/api/extension/dynamicImportAdapter.d.ts

@@ -0,0 +1,21 @@
+import type { ToolAdapter, ToolSpec } from "../../core/types/ToolSpec.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { Evidence } from "../../core/types/ToolResult.js";
+export interface ExtensionToolResult {
+    result: unknown;
+    evidence: Evidence[];
+}
+export interface DynamicImportAdapterOptions<TContext> {
+    kind: string;
+    packageRoot: string;
+    /** Build context from execCtx and (optional) tool spec. When spec is provided, config can be merged from spec._meta.defaultArgs. */
+    getExtensionContext: (execCtx: ExecContext, spec: ToolSpec) => TContext;
+    contextRunner: {
+        runWith(ctx: TContext, fn: () => Promise<ExtensionToolResult>): Promise<ExtensionToolResult>;
+    };
+}
+/**
+ * Create an adapter that loads handlers by spec._meta.sourcePath and exportName, then runs with extension context.
+ */
+export declare function createDynamicImportAdapter<TContext>(options: DynamicImportAdapterOptions<TContext>): ToolAdapter;
+//# sourceMappingURL=dynamicImportAdapter.d.ts.map

package/dist/api/extension/dynamicImportAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicImportAdapter.d.ts","sourceRoot":"","sources":["../../../src/api/extension/dynamicImportAdapter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B,CAAC,QAAQ;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,oIAAoI;IACpI,mBAAmB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC;IACxE,aAAa,EAAE;QAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;KAAE,CAAC;CACjH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EACjD,OAAO,EAAE,2BAA2B,CAAC,QAAQ,CAAC,GAC7C,WAAW,CAqCb"}

package/dist/api/extension/generateExtensionManifest.d.ts

@@ -0,0 +1,24 @@
+export interface GenerateExtensionManifestOptions {
+    /** Project root (default: process.cwd()). */
+    projectRoot?: string;
+    /** Output directory for manifest and copied tool.yaml (default: projectRoot/dist). */
+    outDir?: string;
+    /** Manifest kind (default: "core"). */
+    kind?: string;
+    /** Include globs for TS files (default: all .ts). */
+    include?: string[];
+    /** Path to tsconfig (default: projectRoot/tsconfig.json). */
+    tsconfigPath?: string;
+    /** Subdirs to copy *.tool.yaml from (default: all dirs under projectRoot that contain .tool.yaml). */
+    copyToolYamlDirs?: string[];
+}
+/**
+ * Scan project for @tool, write core-tools-manifest.json and copy *.tool.yaml to outDir.
+ * Returns the written manifest path and number of tools.
+ */
+export declare function generateExtensionManifest(projectRoot?: string, options?: GenerateExtensionManifestOptions): {
+    manifestPath: string;
+    toolsCount: number;
+    toolYamlCopied: number;
+};
+//# sourceMappingURL=generateExtensionManifest.d.ts.map

package/dist/api/extension/generateExtensionManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateExtensionManifest.d.ts","sourceRoot":"","sources":["../../../src/api/extension/generateExtensionManifest.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gCAAgC;IAC/C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,GAAE,MAAsB,EACnC,OAAO,GAAE,gCAAqC,GAC7C;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CA6DtE"}

package/dist/api/extension/groupPrefix.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Convert "groups" + "only" options and a group→prefix map into only/namePrefixes for registerToolsFromManifest.
+ * Extensions define their own group names and prefixes (e.g. fs -> "core/fs.").
+ */
+export interface GroupPrefixOptions {
+    /** Only register tools in these groups (e.g. ["fs", "http"]). */
+    groups?: string[];
+    /** Only register these tool names. Takes precedence over groups. */
+    only?: string[];
+    /** Map group name -> name prefix (e.g. { fs: "core/fs.", http: "core/http." }). */
+    groupPrefixMap: Record<string, string>;
+}
+export interface ResolvedOnlyNamePrefixes {
+    only?: string[];
+    namePrefixes?: string[];
+}
+/**
+ * Resolve groups/only + groupPrefixMap to only and namePrefixes for registerToolsFromManifest.
+ */
+export declare function getGroupNamePrefixes(options: GroupPrefixOptions): ResolvedOnlyNamePrefixes;
+//# sourceMappingURL=groupPrefix.d.ts.map

package/dist/api/extension/groupPrefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupPrefix.d.ts","sourceRoot":"","sources":["../../../src/api/extension/groupPrefix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,wBAAwB,CAS1F"}

package/dist/api/extension/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generic extension primitives: context runner, dynamic-import adapter, manifest registration.
+ * Used by extension packages (e.g. @easynet/agent-tool-buildin) that are "just a normal extension".
+ */
+export { createContextRunner } from "./contextRunner.js";
+export type { ContextRunner } from "./contextRunner.js";
+export { createExtension } from "./createExtension.js";
+export type { CreateExtensionOptions, CreateExtensionResult, ImportMetaLike, RegisterOptionsDefaultOnly, } from "./createExtension.js";
+export { generateExtensionManifest } from "./generateExtensionManifest.js";
+export type { GenerateExtensionManifestOptions } from "./generateExtensionManifest.js";
+export { createDynamicImportAdapter } from "./dynamicImportAdapter.js";
+export type { DynamicImportAdapterOptions, ExtensionToolResult, } from "./dynamicImportAdapter.js";
+export type { ExtensionToolContext, ExtensionToolHandler, } from "./types.js";
+export { loadToolYaml } from "./loadToolYaml.js";
+export { registerToolsFromManifest, loadExtensionManifest, } from "./registerFromManifest.js";
+export { registerExtension } from "./registerExtension.js";
+export type { RegisterExtensionOptions } from "./registerExtension.js";
+export type { ExtensionManifestEntry, LoadedExtensionManifest, RegisterFromManifestOptions, } from "./registerFromManifest.js";
+export { resolveExtensionPackageRoot } from "./resolvePackageRoot.js";
+export { getGroupNamePrefixes } from "./groupPrefix.js";
+export type { GroupPrefixOptions, ResolvedOnlyNamePrefixes, } from "./groupPrefix.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/extension/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/api/extension/loadToolYaml.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load tool.yaml for a given tool. Path: packageRoot / dirname(sourcePath) / basename(sourcePath).tool.yaml
+ * Returns default args (and config) for the tool, or undefined if file missing or no matching entry.
+ */
+export declare function loadToolYaml(packageRoot: string, sourcePath: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=loadToolYaml.d.ts.map

package/dist/api/extension/loadToolYaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadToolYaml.d.ts","sourceRoot":"","sources":["../../../src/api/extension/loadToolYaml.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAuBrC"}

package/dist/api/extension/registerExtension.d.ts

@@ -0,0 +1,31 @@
+/**
+ * One-shot: load pre-built manifest from package, register all specs, create adapter.
+ * Framework does NOT scan source for @tool; it reads manifest (e.g. core-tools-manifest.json)
+ * produced by the extension's build. Extension passes packagePath, config, getContextRunner.
+ */
+import type { ToolAdapter } from "../../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { ContextRunner } from "./contextRunner.js";
+export interface RegisterExtensionOptions<TContext> {
+    /** Package root (e.g. __dirname of extension's entry). Manifest is read from here. */
+    packagePath: string;
+    /** Tool kind; if omitted, uses manifest.kind or "extension". */
+    kind?: string;
+    /** Optional default config; merged with each tool's tool.yaml (spec._meta.defaultArgs). Context config = { ...config, ...toolDefaultArgs }. */
+    config?: unknown;
+    /** Returns the context runner (extension's createContextRunner()). */
+    getContextRunner: () => ContextRunner<TContext>;
+    /** Filter: only register these tool names. */
+    only?: string[];
+    /** Filter: only register tools whose name starts with one of these prefixes. */
+    namePrefixes?: string[];
+}
+/**
+ * Load manifest from package (pre-built JSON; no @tool scanning). Register all specs, create and return adapter.
+ */
+export declare function registerExtension<TContext extends {
+    execCtx: ExecContext;
+    config: unknown;
+}>(registry: ToolRegistry, options: RegisterExtensionOptions<TContext>): ToolAdapter;
+//# sourceMappingURL=registerExtension.d.ts.map

package/dist/api/extension/registerExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerExtension.d.ts","sourceRoot":"","sources":["../../../src/api/extension/registerExtension.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,MAAM,WAAW,wBAAwB,CAAC,QAAQ;IAChD,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+IAA+I;IAC/I,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAC1F,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAC1C,WAAW,CAgCb"}

package/dist/api/extension/registerFromManifest.d.ts

@@ -0,0 +1,40 @@
+import type { ToolSpec, HitlSideEffect } from "../../core/types/ToolSpec.js";
+import type { ToolRegistry } from "../../core/registry/ToolRegistry.js";
+/** Manifest entry shape (convention: extension build emits this, e.g. from @tool scan). */
+export interface ExtensionManifestEntry {
+    coreName: string;
+    description: string;
+    inputSchema: object;
+    outputSchema: object;
+    sourcePath: string;
+    exportName: string;
+    sideEffect: HitlSideEffect;
+}
+/** Loaded manifest: entries + optional kind from manifest file. */
+export interface LoadedExtensionManifest {
+    kind?: string;
+    entries: ExtensionManifestEntry[];
+}
+export interface RegisterFromManifestOptions {
+    /** Path to manifest JSON (or directory containing core-tools-manifest.json). */
+    manifestPathOrDir: string;
+    /** Tool kind; if omitted, uses manifest.kind or "extension". */
+    kind?: string;
+    /** Filter: only register these tool names. */
+    only?: string[];
+    /** Filter: only register tools whose name starts with one of these prefixes. */
+    namePrefixes?: string[];
+    /** Extension package root (e.g. dist); when set, loads <base>.tool.yaml per tool and sets defaultArgs in _meta. */
+    packageRoot?: string;
+}
+/**
+ * Load manifest from path. Supports array or { kind?, tools: ExtensionManifestEntry[] }.
+ * Returns entries + optional kind so framework can use dynamic kind from manifest.
+ */
+export declare function loadExtensionManifest(manifestPathOrDir: string): LoadedExtensionManifest;
+/**
+ * Register tools from a manifest with the registry. Returns the list of registered specs.
+ * Extension packages call this from their register (or equivalent) with their package root.
+ */
+export declare function registerToolsFromManifest(registry: ToolRegistry, options: RegisterFromManifestOptions): ToolSpec[];
+//# sourceMappingURL=registerFromManifest.d.ts.map

package/dist/api/extension/registerFromManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerFromManifest.d.ts","sourceRoot":"","sources":["../../../src/api/extension/registerFromManifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAGxE,2FAA2F;AAC3F,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,cAAc,CAAC;CAC5B;AAED,mEAAmE;AACnE,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,sBAAsB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,iBAAiB,EAAE,MAAM,GAAG,uBAAuB,CAgBxF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,2BAA2B,GACnC,QAAQ,EAAE,CAqCZ"}

package/dist/api/extension/resolvePackageRoot.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveExtensionPackageRoot(metaUrlOrPath: string): string;
+//# sourceMappingURL=resolvePackageRoot.d.ts.map

package/dist/api/extension/resolvePackageRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePackageRoot.d.ts","sourceRoot":"","sources":["../../../src/api/extension/resolvePackageRoot.ts"],"names":[],"mappings":"AAQA,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMzE"}

package/dist/api/extension/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generic extension types: context shape, handler signature.
+ * ExtensionToolResult lives in dynamicImportAdapter (same shape).
+ */
+import type { ExecContext } from "../../core/types/ToolIntent.js";
+import type { ExtensionToolResult } from "./dynamicImportAdapter.js";
+export type { ExtensionToolResult } from "./dynamicImportAdapter.js";
+/** Generic extension context: execCtx + config. Config type is extension-specific. */
+export interface ExtensionToolContext<TConfig = unknown> {
+    execCtx: ExecContext;
+    config: TConfig;
+}
+/** Generic extension handler signature (args only; context via getContext()). */
+export type ExtensionToolHandler = (args: any) => Promise<ExtensionToolResult>;
+//# sourceMappingURL=types.d.ts.map

package/dist/api/extension/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/extension/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,sFAAsF;AACtF,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACrD,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/api/main.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkFWIMPZC2_cjs = require('../chunk-FWIMPZC2.cjs');
-var chunkP2LVZGZ4_cjs = require('../chunk-P2LVZGZ4.cjs');
-var chunkAH4NI4GN_cjs = require('../chunk-AH4NI4GN.cjs');
+var chunkNA2YBWZJ_cjs = require('../chunk-NA2YBWZJ.cjs');
+var chunkB5CAENK6_cjs = require('../chunk-B5CAENK6.cjs');
+var chunkAOEZBP6L_cjs = require('../chunk-AOEZBP6L.cjs');
 require('../chunk-TOSPHMYU.cjs');
 require('../chunk-4KTWJQ32.cjs');
 require('../chunk-DYDNPIV2.cjs');
@@ -11,47 +11,47 @@ require('../chunk-DYDNPIV2.cjs');
 
 Object.defineProperty(exports, "createAgentTools", {
   enumerable: true,
-  get: function () { return chunkFWIMPZC2_cjs.createAgentTools; }
+  get: function () { return chunkNA2YBWZJ_cjs.createAgentTools; }
 });
 Object.defineProperty(exports, "createLangChainToolsAsync", {
   enumerable: true,
-  get: function () { return chunkFWIMPZC2_cjs.createLangChainToolsAsync; }
+  get: function () { return chunkNA2YBWZJ_cjs.createLangChainToolsAsync; }
 });
 Object.defineProperty(exports, "createHttpService", {
   enumerable: true,
-  get: function () { return chunkP2LVZGZ4_cjs.createHttpService; }
+  get: function () { return chunkB5CAENK6_cjs.createHttpService; }
 });
 Object.defineProperty(exports, "createMCPServer", {
   enumerable: true,
-  get: function () { return chunkP2LVZGZ4_cjs.createMCPServer; }
+  get: function () { return chunkB5CAENK6_cjs.createMCPServer; }
 });
 Object.defineProperty(exports, "createMCPServerStreamableHttp", {
   enumerable: true,
-  get: function () { return chunkP2LVZGZ4_cjs.createMCPServerStreamableHttp; }
+  get: function () { return chunkB5CAENK6_cjs.createMCPServerStreamableHttp; }
 });
 Object.defineProperty(exports, "createMCPStreamableHttpHandler", {
   enumerable: true,
-  get: function () { return chunkP2LVZGZ4_cjs.createMCPStreamableHttpHandler; }
+  get: function () { return chunkB5CAENK6_cjs.createMCPStreamableHttpHandler; }
 });
 Object.defineProperty(exports, "createOpenAPIServer", {
   enumerable: true,
-  get: function () { return chunkP2LVZGZ4_cjs.createHttpService; }
+  get: function () { return chunkB5CAENK6_cjs.createHttpService; }
 });
 Object.defineProperty(exports, "runMCPServerOverStdio", {
   enumerable: true,
-  get: function () { return chunkP2LVZGZ4_cjs.runMCPServerOverStdio; }
+  get: function () { return chunkB5CAENK6_cjs.runMCPServerOverStdio; }
 });
 Object.defineProperty(exports, "PTCRuntime", {
   enumerable: true,
-  get: function () { return chunkAH4NI4GN_cjs.PTCRuntime; }
+  get: function () { return chunkAOEZBP6L_cjs.PTCRuntime; }
 });
 Object.defineProperty(exports, "createRuntimeFromConfig", {
   enumerable: true,
-  get: function () { return chunkAH4NI4GN_cjs.createRuntimeFromConfig; }
+  get: function () { return chunkAOEZBP6L_cjs.createRuntimeFromConfig; }
 });
 Object.defineProperty(exports, "createRuntimeFromConfigSync", {
   enumerable: true,
-  get: function () { return chunkAH4NI4GN_cjs.createRuntimeFromConfigSync; }
+  get: function () { return chunkAOEZBP6L_cjs.createRuntimeFromConfigSync; }
 });
 //# sourceMappingURL=main.cjs.map
 //# sourceMappingURL=main.cjs.map

package/dist/api/main.js

@@ -1,6 +1,6 @@
-export { createAgentTools, createLangChainToolsAsync } from '../chunk-ZRDI2RKU.js';
-export { createHttpService, createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, createHttpService as createOpenAPIServer, runMCPServerOverStdio } from '../chunk-QP5FIRC2.js';
-export { PTCRuntime, createRuntimeFromConfig, createRuntimeFromConfigSync } from '../chunk-BPHY6UVK.js';
+export { createAgentTools, createLangChainToolsAsync } from '../chunk-AO2RY5AI.js';
+export { createHttpService, createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, createHttpService as createOpenAPIServer, runMCPServerOverStdio } from '../chunk-JEP26OIY.js';
+export { PTCRuntime, createRuntimeFromConfig, createRuntimeFromConfigSync } from '../chunk-SO32CIHJ.js';
 import '../chunk-ZRHPGW7W.js';
 import '../chunk-3MUOBLNB.js';
 import '../chunk-KDB3MY2H.js';

package/dist/api/runtimeFromConfig.d.ts

@@ -1,20 +1,20 @@
 /**
  * Create PTCRuntime + ToolRegistry from config (sync or async).
- * Registers extension adapters when coreTools/exampleTools options are provided.
- * Extensions are optional; the project does not depend on any specific extension.
- * When configFilePath (tool.yaml) lists npm:@scope/pkg, that package is loaded from
- * cache or node_modules if it exports registerCoreTools. For testing, a default list
- * is used when loading from node_modules without tool.yaml.
+ * Registers extension adapters when coreTools options are provided.
+ * Agent-tool does NOT depend on any specific extension. When configFilePath (tool.yaml)
+ * lists npm:@scope/pkg, that package is loaded from cache or node_modules. The framework
+ * calls the package's default export contract: register(registry, options) -> ToolAdapter.
+ * Extensions implement this contract (e.g. via createExtension from this package).
  */
 import { ToolRegistry } from "../core/registry/ToolRegistry.js";
 import { PTCRuntime } from "../core/runtime/PTCRuntime.js";
 /**
  * Default package names tried when loading an extension from node_modules (no tool.yaml).
- * Used only for testing (e.g. @easynet/agent-tool-buildin). tool.yaml is the source of truth
- * for which extensions to load; any npm: entry there is loaded without an allowlist.
+ * Empty by default so agent-tool does not depend on any specific extension package.
+ * Extensions are loaded only via tool.yaml (npm: entries) or when explicitly configured.
  */
 export declare const DEFAULT_EXTENSION_PACKAGES: string[];
-/** Config for the extension that provides registerCoreTools (e.g. FS, HTTP, util tools). */
+/** Config passed to extension's register(registry, options). */
 export interface CoreToolsUserConfig {
     sandboxRoot?: string;
     /** Allowed hosts (e.g. ["*"] or ["api.github.com"]). Merged with tool.yaml. */

package/dist/api/runtimeFromConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeFromConfig.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAgB3D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,UAItC,CAAC;AAEF,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;CACxB;AA6ED,qKAAqK;AACrK,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQjG;AAsFD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CA6DnG;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}
+{"version":3,"file":"runtimeFromConfig.d.ts","sourceRoot":"","sources":["../../src/api/runtimeFromConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAgB3D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,EAAO,CAAC;AAEvD,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,oEAAoE;IACpE,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,yEAAyE;IACzE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAqFD,qKAAqK;AACrK,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQjG;AAgFD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAqCnG;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAiB9B"}

package/dist/{chunk-AT3N7SQK.cjs → chunk-5CDN24FP.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkAH4NI4GN_cjs = require('./chunk-AH4NI4GN.cjs');
+var chunkAOEZBP6L_cjs = require('./chunk-AOEZBP6L.cjs');
 var chunkDYDNPIV2_cjs = require('./chunk-DYDNPIV2.cjs');
 var fs3 = require('fs/promises');
 var path9 = require('path');
@@ -443,7 +443,8 @@ function getExportedFunctionDeclaration(node, _sourceFile) {
     const exported = (ts2__namespace.getModifiers(node) ?? []).some((m) => m.kind === ts2__namespace.SyntaxKind.ExportKeyword);
     if (!exported) return null;
     for (const decl of node.declarationList.declarations) {
-      const init = decl.initializer;
+      let init = decl.initializer;
+      if (init && ts2__namespace.isParenthesizedExpression(init)) init = init.expression;
       if (init && ts2__namespace.isArrowFunction(init)) {
         const name = decl.name.getText();
         return { func: init, name };
@@ -969,7 +970,7 @@ async function scan4(projectPath, options = {}) {
     });
     return { specs: [], errors };
   }
-  const filtered = specs.filter((s) => s.kind === chunkAH4NI4GN_cjs.MCP_KIND);
+  const filtered = specs.filter((s) => s.kind === chunkAOEZBP6L_cjs.MCP_KIND);
   return { specs: filtered, errors };
 }
 async function scan5(projectPath, options = {}) {
@@ -995,7 +996,7 @@ async function scan5(projectPath, options = {}) {
     });
     return { specs: [], errors };
   }
-  const filtered = specs.filter((s) => s.kind === chunkAH4NI4GN_cjs.LANGCHAIN_KIND);
+  const filtered = specs.filter((s) => s.kind === chunkAOEZBP6L_cjs.LANGCHAIN_KIND);
   return { specs: filtered, errors };
 }
 async function loadLangChainTool(dirPath, manifest, extensions) {
@@ -1412,7 +1413,7 @@ var DirectoryScanner = class {
           false,
           namespace,
           this.extensions,
-          chunkAH4NI4GN_cjs.LANGCHAIN_DIR_NAME,
+          chunkAOEZBP6L_cjs.LANGCHAIN_DIR_NAME,
           (loaded3, nameHint, dp, ns) => this.toToolSpec(loaded3, nameHint, dp, ns),
           this.onError
         );
@@ -1448,7 +1449,7 @@ var DirectoryScanner = class {
         true,
         namespace,
         this.extensions,
-        chunkAH4NI4GN_cjs.LANGCHAIN_DIR_NAME,
+        chunkAOEZBP6L_cjs.LANGCHAIN_DIR_NAME,
         (loaded2, nameHint, dp, ns) => this.toToolSpec(loaded2, nameHint, dp, ns),
         this.onError
       );
@@ -1467,7 +1468,7 @@ var DirectoryScanner = class {
     for (const m of DIRECTORY_KIND_MARKERS) {
       if (await this.fileExists(path9.join(dirPath, m.markerFile))) kinds.push(m.kind);
     }
-    const isLangchainDir = dirName === chunkAH4NI4GN_cjs.LANGCHAIN_DIR_NAME;
+    const isLangchainDir = dirName === chunkAOEZBP6L_cjs.LANGCHAIN_DIR_NAME;
     const hasLangchain = isLangchainDir ? (await listLangchainEntryFiles(dirPath, this.extensions)).length > 0 : dirName !== SKILL_DIR_NAME && await this.hasEntryPoint(dirPath, "index");
     if (hasLangchain) kinds.push("langchain");
     if (kinds.length === 0) return null;
@@ -1606,7 +1607,7 @@ async function scanForAllTools(projectPath, options = {}) {
   const warnings = results.flatMap((r) => r.warnings ?? []);
   return { specs, errors, warnings };
 }
-var __dirname$1 = path9__namespace.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-AT3N7SQK.cjs', document.baseURI).href))));
+var __dirname$1 = path9__namespace.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-5CDN24FP.cjs', document.baseURI).href))));
 async function loadTemplate(name) {
   for (const dir of [
     path9__namespace.join(__dirname$1, "templates"),
@@ -1820,5 +1821,5 @@ exports.scan = scan;
 exports.scanForTools = scanForTools;
 exports.scanSkillResources = scanSkillResources;
 exports.validateFrontmatter = validateFrontmatter;
-//# sourceMappingURL=chunk-AT3N7SQK.cjs.map
-//# sourceMappingURL=chunk-AT3N7SQK.cjs.map
+//# sourceMappingURL=chunk-5CDN24FP.cjs.map
+//# sourceMappingURL=chunk-5CDN24FP.cjs.map