@agentproto/driver 0.1.1

package/LICENSE

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

package/dist/chunk-6NYFD4YS.mjs

@@ -0,0 +1,205 @@
+import matter from 'gray-matter';
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/driver v0.1.0-alpha
+ * AIP-30 DRIVER.md `defineDriver` reference implementation.
+ */
+
+var defineDriver = createDoctype({
+  aip: 30,
+  name: "driver",
+  validate(def) {
+    if (def.implements.length === 0) {
+      throw new Error(
+        `defineDriver: id='${def.id}' must declare \u22651 implements[] entry`
+      );
+    }
+    const previewMap = mergeExecuteMap(def);
+    const declaredToolIds = new Set(
+      def.implements.map((e) => normalizeToolId(e.tool))
+    );
+    const executeKeys = new Set(Object.keys(previewMap));
+    for (const toolId of declaredToolIds) {
+      if (!executeKeys.has(toolId)) {
+        throw new Error(
+          `defineDriver: id='${def.id}' implements '${toolId}' but no execute['${toolId}'] body provided`
+        );
+      }
+    }
+    for (const key of executeKeys) {
+      if (!declaredToolIds.has(key)) {
+        throw new Error(
+          `defineDriver: id='${def.id}' has execute['${key}'] but '${key}' is not in implements[]`
+        );
+      }
+    }
+  },
+  build(def) {
+    const executeMap = mergeExecuteMap(def);
+    return {
+      id: def.id,
+      name: def.name,
+      description: def.description,
+      version: def.version,
+      kind: def.kind,
+      implements: Object.freeze(def.implements.map(freezeImplements)),
+      execute: Object.freeze(executeMap),
+      install: Object.freeze([...def.install ?? []]),
+      versionCheck: def.versionCheck,
+      auth: def.auth,
+      network: Object.freeze({
+        egress: Object.freeze([...def.network?.egress ?? []]),
+        ingress: Object.freeze([...def.network?.ingress ?? []])
+      }),
+      region: Object.freeze([...def.region ?? ["global"]]),
+      policyTags: Object.freeze([...def.policyTags ?? []]),
+      costOverride: def.costOverride,
+      timeoutOverrideMs: def.timeoutOverrideMs,
+      retryOverride: def.retryOverride,
+      healthCheck: def.healthCheck,
+      tags: Object.freeze([...def.tags ?? []]),
+      metadata: Object.freeze({ ...def.metadata ?? {} }),
+      login: def.login,
+      refresh: def.refresh,
+      parseOutput: def.parseOutput,
+      detectExpiry: def.detectExpiry
+    };
+  }
+});
+function mergeExecuteMap(def) {
+  const executeMap = { ...def.execute ?? {} };
+  for (const impl of def.implementations ?? []) {
+    const id = impl.tool.id;
+    const typedBody = impl.body;
+    if (executeMap[id] && executeMap[id] !== typedBody) {
+      throw new Error(
+        `defineDriver: id='${def.id}' has duplicate body for '${id}' \u2014 present in both 'execute' and 'implementations'. Pick one.`
+      );
+    }
+    executeMap[id] = typedBody;
+  }
+  return executeMap;
+}
+function freezeImplements(entry) {
+  return Object.freeze({
+    ...entry,
+    schemaNarrowing: entry.schemaNarrowing ? Object.freeze({
+      dropInputs: Object.freeze([
+        ...entry.schemaNarrowing.dropInputs ?? []
+      ]),
+      dropOutputs: Object.freeze([
+        ...entry.schemaNarrowing.dropOutputs ?? []
+      ])
+    }) : void 0,
+    mapping: entry.mapping ? Object.freeze({ ...entry.mapping }) : void 0,
+    metadata: entry.metadata ? Object.freeze({ ...entry.metadata }) : void 0
+  });
+}
+function normalizeToolId(ref) {
+  let s = ref.trim();
+  if (s.startsWith("./")) s = s.slice(2);
+  if (s.endsWith("/TOOL.md")) s = s.slice(0, -"/TOOL.md".length);
+  if (s.startsWith("tools/")) s = s.slice("tools/".length);
+  const lastSlash = s.lastIndexOf("/");
+  return lastSlash === -1 ? s : s.slice(lastSlash + 1);
+}
+
+// src/manifest/index.ts
+var DRIVER_KIND = z.enum(["cli", "http", "mcp", "sdk", "builtin"]);
+var IMPLEMENTS_ENTRY = z.object({
+  tool: z.string().min(1),
+  version: z.string().min(1),
+  schema_narrowing: z.object({
+    drop_inputs: z.array(z.string()).optional(),
+    drop_outputs: z.array(z.string()).optional()
+  }).optional(),
+  mapping: z.record(
+    z.string(),
+    z.union([
+      z.string(),
+      z.object({ from: z.string(), transform: z.string().optional() })
+    ])
+  ).optional(),
+  cost_override: z.unknown().optional(),
+  timeout_override_ms: z.number().int().positive().optional(),
+  retry_override: z.unknown().optional(),
+  metadata: z.record(z.string(), z.unknown()).optional()
+}).loose();
+var driverManifestFrontmatterSchema = z.object({
+  schema: z.literal("agentproto/driver/v1").optional(),
+  id: z.string().regex(/^[a-z0-9][a-z0-9.\-_]{1,79}$/),
+  name: z.string().min(1).max(120),
+  description: z.string().min(1).max(2e3),
+  version: z.string().regex(/^\d+\.\d+\.\d+/).optional(),
+  kind: DRIVER_KIND,
+  implements: z.array(IMPLEMENTS_ENTRY).min(1),
+  // Universal lifecycle / policy / sandbox blocks. Kept as `unknown`
+  // for block content — the kind-specific runtime packages own the
+  // strict shape; AIP-30 only requires presence + array-ness.
+  install: z.array(z.unknown()).optional(),
+  version_check: z.unknown().optional(),
+  auth: z.unknown().optional(),
+  network: z.object({
+    egress: z.array(z.string()).optional(),
+    ingress: z.array(z.string()).optional()
+  }).optional(),
+  region: z.array(z.string()).optional(),
+  policy_tags: z.array(z.string()).optional(),
+  cost_override: z.unknown().optional(),
+  timeout_override_ms: z.number().int().positive().optional(),
+  retry_override: z.unknown().optional(),
+  health_check: z.unknown().optional(),
+  tags: z.array(z.string()).optional(),
+  metadata: z.record(z.string(), z.unknown()).optional()
+}).loose();
+function parseDriverManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseDriverManifest: missing or empty frontmatter");
+  }
+  const result = driverManifestFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseDriverManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function driverFromManifest(args) {
+  const fm = args.manifest.frontmatter;
+  const definition = {
+    id: fm.id,
+    name: fm.name,
+    description: fm.description,
+    version: fm.version,
+    kind: fm.kind,
+    implements: fm.implements.map((entry) => ({
+      tool: entry.tool,
+      version: entry.version,
+      schemaNarrowing: entry.schema_narrowing ? {
+        dropInputs: entry.schema_narrowing.drop_inputs,
+        dropOutputs: entry.schema_narrowing.drop_outputs
+      } : void 0,
+      mapping: entry.mapping,
+      costOverride: entry.cost_override,
+      timeoutOverrideMs: entry.timeout_override_ms,
+      retryOverride: entry.retry_override,
+      metadata: entry.metadata
+    })),
+    execute: args.execute,
+    implementations: args.implementations,
+    network: fm.network,
+    region: fm.region,
+    policyTags: fm.policy_tags,
+    timeoutOverrideMs: fm.timeout_override_ms,
+    tags: fm.tags,
+    metadata: fm.metadata
+  };
+  return defineDriver(definition);
+}
+
+export { defineDriver, driverFromManifest, driverManifestFrontmatterSchema, normalizeToolId, parseDriverManifest };
+//# sourceMappingURL=chunk-6NYFD4YS.mjs.map
+//# sourceMappingURL=chunk-6NYFD4YS.mjs.map

package/dist/chunk-6NYFD4YS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/define-provider.ts","../src/manifest/index.ts"],"names":[],"mappings":"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","file":"chunk-6NYFD4YS.mjs","sourcesContent":["import { createDoctype } from \"@agentproto/define-doctype\"\nimport type {\n  ExecuteFn,\n  ImplementsEntry,\n  DriverDefinition,\n  DriverHandle,\n} from \"./types.js\"\n\n/**\n * AIP-30 reference implementation of `defineDriver`.\n *\n * Returns a {@link DriverHandle} with defaults applied. The resolver\n * (`resolveDriver`) and runners (`runTool`) consume this shape and\n * dispatch contract calls to the per-tool execute bodies.\n *\n * Built on `createDoctype` from `@agentproto/define-doctype`: the\n * id-pattern + description-length validation and the top-level\n * `Object.freeze` are shared with every other AIP defineX. The\n * spec-30-specific parts (implements vs execute consistency, merging\n * `implementations[]` into the execute map, freezing nested arrays\n * and objects) live in `validate` and `build` below.\n *\n * Conformance highlights ([§ Conformance rules](https://agentproto.sh/docs/aip-30)):\n *  - Frontmatter is the source of truth — entries warn on mismatch and prefer frontmatter.\n *  - `execute[<toolId>]` MUST exist for every `implements[]` entry.\n *  - No I/O at module load — `defineDriver(...)` is pure construction.\n *\n * Two body-binding paths are accepted:\n *\n *  1. **Legacy bag** — `execute: { [toolId]: ExecuteFn }`. Used by\n *     `.md`-driven dynamic loading where the contract handle isn't\n *     in scope. Bodies receive `unknown`-typed inputs and must cast.\n *  2. **Typed implementations** — `implementations: ToolImplementation[]`.\n *     Each impl carries its contract handle so the body's `input`,\n *     `context`, and return are checked against the contract's\n *     generics at compile time. Authors get IERC20-style type safety.\n *\n * Both can coexist on the same provider. On the same tool id, the\n * typed `implementations[]` form wins over the legacy bag.\n */\nexport const defineDriver = createDoctype<DriverDefinition, DriverHandle>({\n  aip: 30,\n  name: \"driver\",\n  validate(def) {\n    if (def.implements.length === 0) {\n      throw new Error(\n        `defineDriver: id='${def.id}' must declare ≥1 implements[] entry`,\n      )\n    }\n    // The execute-map vs implements[] consistency check needs the merged\n    // map; building it once and validating in `build` is fine — but we\n    // also want a precise error on per-tool missing bodies before we\n    // commit to the build path. Run that check here against a previewed\n    // merged map so the thrown message matches the historical wording\n    // (\"implements 'X' but no execute['X'] body provided\").\n    const previewMap = mergeExecuteMap(def)\n    const declaredToolIds = new Set(\n      def.implements.map((e) => normalizeToolId(e.tool)),\n    )\n    const executeKeys = new Set(Object.keys(previewMap))\n    for (const toolId of declaredToolIds) {\n      if (!executeKeys.has(toolId)) {\n        throw new Error(\n          `defineDriver: id='${def.id}' implements '${toolId}' but no execute['${toolId}'] body provided`,\n        )\n      }\n    }\n    for (const key of executeKeys) {\n      if (!declaredToolIds.has(key)) {\n        throw new Error(\n          `defineDriver: id='${def.id}' has execute['${key}'] but '${key}' is not in implements[]`,\n        )\n      }\n    }\n  },\n  build(def) {\n    const executeMap = mergeExecuteMap(def)\n    return {\n      id: def.id,\n      name: def.name,\n      description: def.description,\n      version: def.version,\n      kind: def.kind,\n      implements: Object.freeze(def.implements.map(freezeImplements)),\n      execute: Object.freeze(executeMap),\n      install: Object.freeze([...(def.install ?? [])]),\n      versionCheck: def.versionCheck,\n      auth: def.auth,\n      network: Object.freeze({\n        egress: Object.freeze([...(def.network?.egress ?? [])]),\n        ingress: Object.freeze([...(def.network?.ingress ?? [])]),\n      }),\n      region: Object.freeze([...(def.region ?? [\"global\"])]),\n      policyTags: Object.freeze([...(def.policyTags ?? [])]),\n      costOverride: def.costOverride,\n      timeoutOverrideMs: def.timeoutOverrideMs,\n      retryOverride: def.retryOverride,\n      healthCheck: def.healthCheck,\n      tags: Object.freeze([...(def.tags ?? [])]),\n      metadata: Object.freeze({ ...(def.metadata ?? {}) }),\n      login: def.login,\n      refresh: def.refresh,\n      parseOutput: def.parseOutput,\n      detectExpiry: def.detectExpiry,\n    }\n  },\n})\n\n/**\n * Merge typed `implementations[]` into the runtime execute map. Each\n * ToolImplementation carries its contract handle, so we read\n * `impl.tool.id` to derive the binding key — authors don't restate\n * the id as a string. Typed bindings beat legacy bag on collision; a\n * collision with a *different* body raises an error so there's never\n * ambiguity about which body the resolver dispatched.\n */\nfunction mergeExecuteMap(def: DriverDefinition): Record<string, ExecuteFn> {\n  const executeMap: Record<string, ExecuteFn> = { ...(def.execute ?? {}) }\n  for (const impl of def.implementations ?? []) {\n    const id = impl.tool.id\n    const typedBody = impl.body as ExecuteFn\n    if (executeMap[id] && executeMap[id] !== typedBody) {\n      throw new Error(\n        `defineDriver: id='${def.id}' has duplicate body for '${id}' — ` +\n          `present in both 'execute' and 'implementations'. Pick one.`,\n      )\n    }\n    executeMap[id] = typedBody\n  }\n  return executeMap\n}\n\nfunction freezeImplements(entry: ImplementsEntry): ImplementsEntry {\n  return Object.freeze({\n    ...entry,\n    schemaNarrowing: entry.schemaNarrowing\n      ? Object.freeze({\n          dropInputs: Object.freeze([\n            ...(entry.schemaNarrowing.dropInputs ?? []),\n          ]),\n          dropOutputs: Object.freeze([\n            ...(entry.schemaNarrowing.dropOutputs ?? []),\n          ]),\n        })\n      : undefined,\n    mapping: entry.mapping ? Object.freeze({ ...entry.mapping }) : undefined,\n    metadata: entry.metadata ? Object.freeze({ ...entry.metadata }) : undefined,\n  })\n}\n\n/**\n * Normalise a tool ref (`./tools/foo/TOOL.md`, `tools/foo`,\n * `foo`) to its canonical id used as the `execute` map key.\n *\n * v1: strip leading `./`, strip `/TOOL.md` suffix, strip `tools/`\n * prefix, take the last path segment when no other normalisation\n * applies. Matches the convention in EXAMPLES.md.\n */\nexport function normalizeToolId(ref: string): string {\n  let s = ref.trim()\n  if (s.startsWith(\"./\")) s = s.slice(2)\n  if (s.endsWith(\"/TOOL.md\")) s = s.slice(0, -\"/TOOL.md\".length)\n  if (s.startsWith(\"tools/\")) s = s.slice(\"tools/\".length)\n  // Last segment when path-shaped; otherwise the whole string.\n  const lastSlash = s.lastIndexOf(\"/\")\n  return lastSlash === -1 ? s : s.slice(lastSlash + 1)\n}\n","/**\n * AIP-30 DRIVER.md sidecar parser + manifest-to-handle constructor.\n *\n * Mirror of `@agentproto/tool/manifest`: the .md provides\n * metadata + dispatch declarations (`implements[]`, `install`, `auth`,\n * `network`, …); the TS module supplies the execute bodies. Both inputs\n * end up in `defineDriver` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, error prefix) run uniformly.\n *\n * The frontmatter schema below covers the AIP-30 §\"Frontmatter\" block\n * loosely — only the universally-required fields are strictly typed\n * (id, name, description, version, kind, implements). Subtype-specific\n * extras (CLI argv, HTTP endpoints, MCP tool names) live under\n * `metadata` or `implements[].metadata` with `unknown`-typed values\n * and are validated by the kind-specific runtime packages, not here.\n */\n\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\nimport { defineDriver } from \"../define-provider.js\"\nimport type { ToolImplementation } from \"../implement-tool.js\"\nimport type {\n  DriverDefinition,\n  DriverHandle,\n  ExecuteFn,\n} from \"../types.js\"\n\nconst DRIVER_KIND = z.enum([\"cli\", \"http\", \"mcp\", \"sdk\", \"builtin\"])\n\nconst IMPLEMENTS_ENTRY = z\n  .object({\n    tool: z.string().min(1),\n    version: z.string().min(1),\n    schema_narrowing: z\n      .object({\n        drop_inputs: z.array(z.string()).optional(),\n        drop_outputs: z.array(z.string()).optional(),\n      })\n      .optional(),\n    mapping: z\n      .record(\n        z.string(),\n        z.union([\n          z.string(),\n          z.object({ from: z.string(), transform: z.string().optional() }),\n        ]),\n      )\n      .optional(),\n    cost_override: z.unknown().optional(),\n    timeout_override_ms: z.number().int().positive().optional(),\n    retry_override: z.unknown().optional(),\n    metadata: z.record(z.string(), z.unknown()).optional(),\n  })\n  .loose()\n\nexport const driverManifestFrontmatterSchema = z\n  .object({\n    schema: z.literal(\"agentproto/driver/v1\").optional(),\n    id: z.string().regex(/^[a-z0-9][a-z0-9.\\-_]{1,79}$/),\n    name: z.string().min(1).max(120),\n    description: z.string().min(1).max(2000),\n    version: z.string().regex(/^\\d+\\.\\d+\\.\\d+/).optional(),\n    kind: DRIVER_KIND,\n    implements: z.array(IMPLEMENTS_ENTRY).min(1),\n\n    // Universal lifecycle / policy / sandbox blocks. Kept as `unknown`\n    // for block content — the kind-specific runtime packages own the\n    // strict shape; AIP-30 only requires presence + array-ness.\n    install: z.array(z.unknown()).optional(),\n    version_check: z.unknown().optional(),\n    auth: z.unknown().optional(),\n    network: z\n      .object({\n        egress: z.array(z.string()).optional(),\n        ingress: z.array(z.string()).optional(),\n      })\n      .optional(),\n    region: z.array(z.string()).optional(),\n    policy_tags: z.array(z.string()).optional(),\n    cost_override: z.unknown().optional(),\n    timeout_override_ms: z.number().int().positive().optional(),\n    retry_override: z.unknown().optional(),\n    health_check: z.unknown().optional(),\n\n    tags: z.array(z.string()).optional(),\n    metadata: z.record(z.string(), z.unknown()).optional(),\n  })\n  .loose()\n\nexport type DriverManifestFrontmatter = z.infer<\n  typeof driverManifestFrontmatterSchema\n>\n\nexport interface DriverManifest {\n  frontmatter: DriverManifestFrontmatter\n  body: string\n}\n\n/**\n * Parse a DRIVER.md source string into structured frontmatter + body.\n * Throws on missing frontmatter or schema-invalid frontmatter.\n */\nexport function parseDriverManifest(source: string): DriverManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseDriverManifest: missing or empty frontmatter\")\n  }\n  const result = driverManifestFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseDriverManifest: invalid frontmatter — ${result.error.issues\n        .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n        .join(\"; \")}`,\n    )\n  }\n  return { frontmatter: result.data, body: parsed.content }\n}\n\n/**\n * Build a {@link DriverHandle} from a parsed `DRIVER.md` manifest +\n * caller-supplied execute bodies. The .md is the source of truth for\n * dispatch metadata (`implements[]`, install, auth, network, …); the\n * TS module supplies the actual function bodies via `execute` (legacy\n * keyed bag) or `implementations` (typed via `implementTool(handle, body)`).\n *\n * Mirrors `toolFromManifest`: same shape, same single source of truth\n * principle. Goes through `defineDriver` so the AIP-30 invariants\n * (`implements[]` ↔ execute consistency, top-level freeze, error\n * prefix) run uniformly with the TS path.\n *\n * @example\n *   const manifest = parseDriverManifest(readFileSync(\"./gh-cli/DRIVER.md\", \"utf8\"))\n *   const ghCli = driverFromManifest({\n *     manifest,\n *     execute: {\n *       \"list-prs\": async ({ input }) => { ... },\n *     },\n *   })\n */\nexport function driverFromManifest(args: {\n  manifest: DriverManifest\n  execute?: Record<string, ExecuteFn>\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  implementations?: readonly ToolImplementation<any, any, any>[]\n}): DriverHandle {\n  const fm = args.manifest.frontmatter\n\n  const definition: DriverDefinition = {\n    id: fm.id,\n    name: fm.name,\n    description: fm.description,\n    version: fm.version,\n    kind: fm.kind,\n    implements: fm.implements.map((entry) => ({\n      tool: entry.tool,\n      version: entry.version,\n      schemaNarrowing: entry.schema_narrowing\n        ? {\n            dropInputs: entry.schema_narrowing.drop_inputs,\n            dropOutputs: entry.schema_narrowing.drop_outputs,\n          }\n        : undefined,\n      mapping: entry.mapping,\n      costOverride: entry.cost_override as DriverDefinition[\"costOverride\"],\n      timeoutOverrideMs: entry.timeout_override_ms,\n      retryOverride: entry.retry_override as DriverDefinition[\"retryOverride\"],\n      metadata: entry.metadata,\n    })),\n    execute: args.execute,\n    implementations: args.implementations,\n    network: fm.network,\n    region: fm.region,\n    policyTags: fm.policy_tags,\n    timeoutOverrideMs: fm.timeout_override_ms,\n    tags: fm.tags,\n    metadata: fm.metadata,\n  }\n\n  return defineDriver(definition)\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+import { D as DriverDefinition, a as DriverHandle, R as ResolverContext, b as ResolverResult, M as MappingValue } from './types-U3ItqOQG.js';
+export { A as AuthConfig, c as AuthLoginConfig, d as AuthRefreshConfig, C as CostOverride, e as DetectExpiryArgs, f as DriverContext, E as ExecuteArgs, g as ExecuteFn, H as HealthCheckConfig, I as ImplementsEntry, h as InstallMethod, L as LoginArgs, i as LoginResult, P as ParseOutputArgs, j as ParseOutputResult, k as RefreshArgs, l as RefreshResult, m as ResolverInput, n as RetryPolicy, T as ToolImplementation, o as TypedExecuteFn, V as VersionCheck, p as implementTool } from './types-U3ItqOQG.js';
+import { ToolHandle, ToolContext } from '@agentproto/tool';
+import * as _agentproto_manifest from '@agentproto/manifest';
+import { DoctypeSpec } from '@agentproto/manifest';
+
+/**
+ * AIP-30 reference implementation of `defineDriver`.
+ *
+ * Returns a {@link DriverHandle} with defaults applied. The resolver
+ * (`resolveDriver`) and runners (`runTool`) consume this shape and
+ * dispatch contract calls to the per-tool execute bodies.
+ *
+ * Built on `createDoctype` from `@agentproto/define-doctype`: the
+ * id-pattern + description-length validation and the top-level
+ * `Object.freeze` are shared with every other AIP defineX. The
+ * spec-30-specific parts (implements vs execute consistency, merging
+ * `implementations[]` into the execute map, freezing nested arrays
+ * and objects) live in `validate` and `build` below.
+ *
+ * Conformance highlights ([§ Conformance rules](https://agentproto.sh/docs/aip-30)):
+ *  - Frontmatter is the source of truth — entries warn on mismatch and prefer frontmatter.
+ *  - `execute[<toolId>]` MUST exist for every `implements[]` entry.
+ *  - No I/O at module load — `defineDriver(...)` is pure construction.
+ *
+ * Two body-binding paths are accepted:
+ *
+ *  1. **Legacy bag** — `execute: { [toolId]: ExecuteFn }`. Used by
+ *     `.md`-driven dynamic loading where the contract handle isn't
+ *     in scope. Bodies receive `unknown`-typed inputs and must cast.
+ *  2. **Typed implementations** — `implementations: ToolImplementation[]`.
+ *     Each impl carries its contract handle so the body's `input`,
+ *     `context`, and return are checked against the contract's
+ *     generics at compile time. Authors get IERC20-style type safety.
+ *
+ * Both can coexist on the same provider. On the same tool id, the
+ * typed `implementations[]` form wins over the legacy bag.
+ */
+declare const defineDriver: (def: DriverDefinition) => DriverHandle;
+/**
+ * Normalise a tool ref (`./tools/foo/TOOL.md`, `tools/foo`,
+ * `foo`) to its canonical id used as the `execute` map key.
+ *
+ * v1: strip leading `./`, strip `/TOOL.md` suffix, strip `tools/`
+ * prefix, take the last path segment when no other normalisation
+ * applies. Matches the convention in EXAMPLES.md.
+ */
+declare function normalizeToolId(ref: string): string;
+
+/**
+ * AIP-30 6-phase resolver. Picks one provider per call.
+ *
+ * Algorithm summary (full description in AIP-30 § Multi-provider routing):
+ *
+ *  Phase 1 — Candidate set: filter providers implementing(tool.id) and
+ *           respecting tool.driverConstraints (forbid / requireKind)
+ *           and per-call schema_narrowing compatibility.
+ *  Phase 2 — Capability gate: drop providers with failed install /
+ *           version_check or stale failed health_check.
+ *  Phase 3 — Policy filter: drop providers violating policy_tags
+ *           allowlist or missing region match.
+ *  Phase 4 — Pin override: if context.pinnedProvider, return it or fail.
+ *  Phase 5 — Cost / preference rank: default_driver first, else by
+ *           cost_units_per_call → kind preference → recency → lex(id).
+ *  Phase 6 — Bind: return { provider, implementsEntry }.
+ */
+declare function resolveDriver(args: {
+    tool: ToolHandle;
+    candidates: readonly DriverHandle[];
+    context: ResolverContext;
+    /** Inputs the call is using; used in narrowing compatibility check. */
+    inputKeys?: readonly string[];
+    /** Per-provider availability (capability gate from Phase 2). */
+    availability?: Map<string, DriverAvailability>;
+}): ResolverResult;
+interface DriverAvailability {
+    installFailed?: boolean;
+    versionMismatch?: boolean;
+    authState?: "unknown" | "unauthed" | "authed" | "expired";
+    healthCheckFailedRecently?: boolean;
+    /** Last successful health-check timestamp, ISO-8601. */
+    lastHealthOk?: string;
+}
+
+/**
+ * End-to-end dispatch of a TOOL contract through the AIP-30 resolver.
+ *
+ *  1. Resolve a provider via the 6-phase resolver.
+ *  2. Validate input + context against the contract's schemas (host's job, not provider's).
+ *  3. Apply mapping + schema-narrowing (refuse calls using dropped inputs).
+ *  4. Build per-call DriverContext (resolved secrets, signal).
+ *  5. Invoke `provider.execute[tool.id]({ input, context, driverCtx, signal })`.
+ *  6. Validate output against contract's outputSchema.
+ *  7. Return the typed result.
+ *
+ * Errors throw {@link ToolError}; consumers wrap into the standard
+ * `ToolResult<T>` envelope at the boundary.
+ */
+declare function runTool<TInput, TOutput, TContext extends ToolContext>(args: {
+    tool: ToolHandle<TInput, TOutput, TContext>;
+    candidates: readonly DriverHandle[];
+    input: unknown;
+    context?: unknown;
+    resolverContext?: ResolverContext;
+    availability?: Map<string, DriverAvailability>;
+    /** Resolved secrets to inject into DriverContext. */
+    secrets?: Record<string, string>;
+    /** Caller-set abort signal. Must be honoured. */
+    signal?: AbortSignal;
+}): Promise<TOutput>;
+/**
+ * Apply the implements entry's `mapping` to the input shape. v1
+ * supports identity rename (`prompt: prompt`), key rename
+ * (`style: artistic_style`), and `{ from, transform }` (the runtime
+ * looks up `transform` on the provider's transformer registry — out
+ * of scope for v1; we pass through the original value).
+ *
+ * When `mapping` is omitted, the input is returned verbatim.
+ */
+declare function applyMapping(input: unknown, mapping: Record<string, MappingValue> | undefined): unknown;
+
+declare const driverSpec: DoctypeSpec<DriverDefinition, DriverHandle>;
+declare const driverVerbs: _agentproto_manifest.Verbs<DriverDefinition, DriverHandle>;
+
+/**
+ * @agentproto/driver — AIP-30 DRIVER.md `defineDriver`
+ * reference implementation + 6-phase resolver + per-call dispatch.
+ *
+ * Spec: https://agentproto.sh/docs/aip-30
+ */
+declare const SPEC_NAME: "agentdriver/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { type DriverAvailability, DriverDefinition, DriverHandle, MappingValue, ResolverContext, ResolverResult, SPEC_NAME, SPEC_VERSION, applyMapping, defineDriver, driverSpec, driverVerbs, normalizeToolId, resolveDriver, runTool };