hono-apcore 0.1.0

package/dist/schema/adapters/zod.adapter.js

@@ -0,0 +1,372 @@
+function hasSafeParse(input) {
+    return (input !== null &&
+        typeof input === 'object' &&
+        'safeParse' in input &&
+        typeof input['safeParse'] === 'function');
+}
+function isZodV3(input) {
+    if (!hasSafeParse(input))
+        return false;
+    const def = input['_def'];
+    return (def !== null &&
+        typeof def === 'object' &&
+        typeof def.typeName === 'string');
+}
+function isZodV4(input) {
+    if (!hasSafeParse(input))
+        return false;
+    const internals = input['_zod'];
+    if (internals === null || typeof internals !== 'object')
+        return false;
+    const def = internals['def'];
+    return def !== null && typeof def === 'object' && typeof def.type === 'string';
+}
+/** A `.description` set via `.describe()` — available on both Zod 3 and 4. */
+function describedAs(schema) {
+    return typeof schema.description === 'string' && schema.description.length > 0
+        ? schema.description
+        : undefined;
+}
+function withDescription(result, schema) {
+    const description = describedAs(schema);
+    if (description !== undefined && result['description'] === undefined) {
+        result['description'] = description;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Enum helpers (shared by both major versions)
+// ---------------------------------------------------------------------------
+/**
+ * Build the JSON Schema fragment for an enum from its entries object.
+ *
+ * TypeScript numeric enums are emitted with a reverse mapping — `enum Color
+ * { Red = 0 }` compiles to `{ 0: 'Red', Red: 0 }` — and only the forward
+ * entries are values a caller may actually send. An entry is a reverse
+ * mapping when its value is a string that is itself a key holding the number
+ * this key spells.
+ *
+ * `type` is only emitted when every surviving value shares one JSON type;
+ * a mixed enum carries `enum` alone.
+ */
+function enumFromEntries(entries) {
+    const values = Object.entries(entries)
+        .filter(([key, value]) => {
+        if (typeof value !== 'string')
+            return true;
+        const roundTrip = entries[value];
+        return typeof roundTrip !== 'number' || String(roundTrip) !== key;
+    })
+        .map(([, value]) => value);
+    const result = { enum: values };
+    if (values.length > 0 && values.every((v) => typeof v === 'string')) {
+        result['type'] = 'string';
+    }
+    else if (values.length > 0 && values.every((v) => typeof v === 'number')) {
+        result['type'] = 'number';
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Zod 3 -> JSON Schema
+// ---------------------------------------------------------------------------
+function convertV3(schema) {
+    const def = schema._def;
+    const typeName = def.typeName ?? '';
+    let result;
+    switch (typeName) {
+        case 'ZodString':
+            result = { type: 'string' };
+            break;
+        case 'ZodNumber':
+            result = convertV3Number(def);
+            break;
+        case 'ZodBoolean':
+            result = { type: 'boolean' };
+            break;
+        case 'ZodObject':
+            result = convertV3Object(def);
+            break;
+        case 'ZodArray':
+            result = { type: 'array', items: convertV3(def['type']) };
+            break;
+        case 'ZodEnum':
+            result = { type: 'string', enum: [...def['values']] };
+            break;
+        case 'ZodNativeEnum':
+            result = enumFromEntries(def['values']);
+            break;
+        case 'ZodOptional':
+            result = convertV3(def['innerType']);
+            break;
+        case 'ZodNullable':
+            result = { ...convertV3(def['innerType']), nullable: true };
+            break;
+        case 'ZodDefault':
+            result = {
+                ...convertV3(def['innerType']),
+                default: def['defaultValue'](),
+            };
+            break;
+        case 'ZodLiteral': {
+            const value = def['value'];
+            result = { type: typeof value, const: value };
+            break;
+        }
+        case 'ZodUnion':
+            result = { anyOf: def['options'].map(convertV3) };
+            break;
+        case 'ZodRecord':
+            result = {
+                type: 'object',
+                additionalProperties: convertV3(def['valueType']),
+            };
+            break;
+        case 'ZodEffects':
+            result = convertV3(def['schema']);
+            break;
+        default:
+            result = {};
+            break;
+    }
+    if (typeof def.description === 'string' && def.description.length > 0) {
+        result['description'] = def.description;
+    }
+    return withDescription(result, schema);
+}
+function convertV3Number(def) {
+    const checks = def['checks'] ?? [];
+    const result = {};
+    let type = 'number';
+    for (const check of checks) {
+        switch (check.kind) {
+            case 'int':
+                type = 'integer';
+                break;
+            case 'min':
+                result['minimum'] = check.value;
+                break;
+            case 'max':
+                result['maximum'] = check.value;
+                break;
+        }
+    }
+    result['type'] = type;
+    return result;
+}
+function convertV3Object(def) {
+    const shapeFn = def['shape'];
+    const shape = typeof shapeFn === 'function' ? shapeFn() : undefined;
+    if (!shape)
+        return { type: 'object' };
+    const properties = {};
+    const required = [];
+    for (const [key, field] of Object.entries(shape)) {
+        properties[key] = convertV3(field);
+        const fieldType = field._def.typeName;
+        if (fieldType !== 'ZodOptional' && fieldType !== 'ZodDefault') {
+            required.push(key);
+        }
+    }
+    const result = { type: 'object', properties };
+    if (required.length > 0)
+        result['required'] = required;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Zod 4 -> JSON Schema
+// ---------------------------------------------------------------------------
+/** Type names that make an object property optional in Zod 4. */
+const V4_OPTIONAL_TYPES = new Set(['optional', 'default', 'prefault']);
+function v4Def(schema) {
+    return schema._zod.def;
+}
+function convertV4(schema) {
+    const def = v4Def(schema);
+    let result;
+    switch (def.type) {
+        case 'string':
+            result = convertV4String(def);
+            break;
+        case 'number':
+        case 'int':
+            result = convertV4Number(def);
+            break;
+        case 'bigint':
+            result = { type: 'integer' };
+            break;
+        case 'boolean':
+            result = { type: 'boolean' };
+            break;
+        case 'date':
+            result = { type: 'string', format: 'date-time' };
+            break;
+        case 'null':
+            result = { type: 'null' };
+            break;
+        case 'object':
+            result = convertV4Object(def);
+            break;
+        case 'array':
+            result = { type: 'array', items: convertV4(def['element']) };
+            break;
+        case 'enum':
+            result = enumFromEntries(def['entries'] ?? {});
+            break;
+        case 'literal': {
+            const values = def['values'] ?? [];
+            result =
+                values.length === 1
+                    ? { type: typeof values[0], const: values[0] }
+                    : { enum: [...values] };
+            break;
+        }
+        case 'optional':
+        case 'nonoptional':
+        case 'readonly':
+        case 'catch':
+            result = convertV4(def['innerType']);
+            break;
+        case 'nullable':
+            result = { ...convertV4(def['innerType']), nullable: true };
+            break;
+        case 'default':
+        case 'prefault':
+            result = {
+                ...convertV4(def['innerType']),
+                default: def['defaultValue'],
+            };
+            break;
+        case 'union':
+            result = { anyOf: def['options'].map(convertV4) };
+            break;
+        case 'record':
+            result = {
+                type: 'object',
+                additionalProperties: convertV4(def['valueType']),
+            };
+            break;
+        case 'pipe':
+            // `.transform()` / `z.coerce.*` wrap the source schema in a pipe; the
+            // input side is what a caller must supply.
+            result = convertV4(def['in']);
+            break;
+        default:
+            result = {};
+            break;
+    }
+    return withDescription(result, schema);
+}
+/** Read the `_zod.def` of a Zod 4 check object. */
+function v4CheckDef(check) {
+    const internals = check?.['_zod'];
+    if (internals === null || typeof internals !== 'object')
+        return {};
+    return internals['def'] ?? {};
+}
+function convertV4String(def) {
+    const result = { type: 'string' };
+    for (const check of def['checks'] ?? []) {
+        const cd = v4CheckDef(check);
+        switch (cd['check']) {
+            case 'min_length':
+                result['minLength'] = cd['minimum'];
+                break;
+            case 'max_length':
+                result['maxLength'] = cd['maximum'];
+                break;
+            case 'length_equals':
+                result['minLength'] = cd['length'];
+                result['maxLength'] = cd['length'];
+                break;
+            case 'string_format':
+                if (typeof cd['format'] === 'string' && cd['format'] !== 'regex') {
+                    result['format'] = cd['format'];
+                }
+                break;
+        }
+    }
+    // `z.email()` and friends put the format on the def itself, not in checks.
+    if (typeof def['format'] === 'string' && result['format'] === undefined) {
+        result['format'] = def['format'];
+    }
+    return result;
+}
+/** Zod 4 numeric formats that map to JSON Schema `integer`. */
+const V4_INT_FORMATS = new Set(['safeint', 'int32', 'uint32', 'int64', 'uint64']);
+function convertV4Number(def) {
+    const result = {};
+    let type = def.type === 'int' ? 'integer' : 'number';
+    for (const check of def['checks'] ?? []) {
+        const cd = v4CheckDef(check);
+        switch (cd['check']) {
+            case 'number_format':
+                if (typeof cd['format'] === 'string' && V4_INT_FORMATS.has(cd['format'])) {
+                    type = 'integer';
+                }
+                break;
+            case 'greater_than':
+                if (cd['inclusive'])
+                    result['minimum'] = cd['value'];
+                else
+                    result['exclusiveMinimum'] = cd['value'];
+                break;
+            case 'less_than':
+                if (cd['inclusive'])
+                    result['maximum'] = cd['value'];
+                else
+                    result['exclusiveMaximum'] = cd['value'];
+                break;
+            case 'multiple_of':
+                result['multipleOf'] = cd['value'];
+                break;
+        }
+    }
+    result['type'] = type;
+    return result;
+}
+function convertV4Object(def) {
+    const shape = def['shape'];
+    if (!shape)
+        return { type: 'object' };
+    const properties = {};
+    const required = [];
+    for (const [key, field] of Object.entries(shape)) {
+        properties[key] = convertV4(field);
+        if (!V4_OPTIONAL_TYPES.has(v4Def(field).type ?? '')) {
+            required.push(key);
+        }
+    }
+    const result = { type: 'object', properties };
+    if (required.length > 0)
+        result['required'] = required;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+/**
+ * Schema adapter for Zod, supporting both Zod 3 and Zod 4.
+ *
+ * Detection and conversion are structural — Zod is never imported — so the
+ * adapter works whichever major version (if any) the host app installs.
+ * Zod 3 is recognised by `_def.typeName`, Zod 4 by `_zod.def.type`.
+ */
+export class ZodAdapter {
+    name = 'zod';
+    priority = 50;
+    detect(input) {
+        return isZodV3(input) || isZodV4(input);
+    }
+    extract(input) {
+        return this.extractJsonSchema(input);
+    }
+    extractJsonSchema(input) {
+        if (isZodV4(input))
+            return convertV4(input);
+        if (isZodV3(input))
+            return convertV3(input);
+        throw new Error('ZodAdapter.extractJsonSchema: input is not a Zod schema');
+    }
+}
+//# sourceMappingURL=zod.adapter.js.map

package/dist/schema/adapters/zod.adapter.js.map

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

package/dist/schema/index.d.ts

@@ -0,0 +1,6 @@
+export { SchemaExtractor, SchemaExtractionError, defaultSchemaExtractor } from './schema-extractor.js';
+export type { SchemaAdapter } from './adapters/schema-adapter.interface.js';
+export { TypeBoxAdapter } from './adapters/typebox.adapter.js';
+export { ZodAdapter } from './adapters/zod.adapter.js';
+export { JsonSchemaAdapter } from './adapters/json-schema.adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACvG,YAAY,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,5 @@
+export { SchemaExtractor, SchemaExtractionError, defaultSchemaExtractor } from './schema-extractor.js';
+export { TypeBoxAdapter } from './adapters/typebox.adapter.js';
+export { ZodAdapter } from './adapters/zod.adapter.js';
+export { JsonSchemaAdapter } from './adapters/json-schema.adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/schema/schema-extractor.d.ts

@@ -0,0 +1,51 @@
+import type { TSchema } from '@sinclair/typebox';
+import type { SchemaAdapter } from './adapters/schema-adapter.interface.js';
+/** Thrown when no registered adapter can handle the provided input. */
+export declare class SchemaExtractionError extends Error {
+    readonly name = "SchemaExtractionError";
+    constructor(message: string);
+}
+/**
+ * Delegates schema detection and conversion to a prioritised chain of
+ * {@link SchemaAdapter}s.
+ *
+ * Built-in adapters, tried in descending priority order:
+ *
+ * | Adapter            | Priority |
+ * |--------------------|----------|
+ * | TypeBoxAdapter     | 100      |
+ * | ZodAdapter         | 50       |
+ * | JsonSchemaAdapter  | 30       |
+ *
+ * Register your own with {@link registerAdapter}; it is inserted into the
+ * chain according to its `priority`.
+ */
+export declare class SchemaExtractor {
+    private adapters;
+    constructor(adapters?: SchemaAdapter[]);
+    /** Add a custom adapter and re-sort the chain (highest priority first). */
+    registerAdapter(adapter: SchemaAdapter): void;
+    /** Names of the adapters in the chain, highest priority first. */
+    get adapterNames(): string[];
+    /**
+     * Name of the first adapter that claims `input`, or `null` when none
+     * recognises it.
+     */
+    detect(input: unknown): string | null;
+    /**
+     * Extract a TypeBox-compatible `TSchema` from `input`.
+     *
+     * @throws {SchemaExtractionError} When no adapter can handle the input.
+     */
+    extract(input: unknown): TSchema;
+    /**
+     * Extract a plain JSON Schema object from `input`.
+     *
+     * @throws {SchemaExtractionError} When no adapter can handle the input.
+     */
+    extractJsonSchema(input: unknown): Record<string, unknown>;
+    private sortAdapters;
+}
+/** Process-wide extractor used by the tool registrar and route scanner. */
+export declare const defaultSchemaExtractor: SchemaExtractor;
+//# sourceMappingURL=schema-extractor.d.ts.map

package/dist/schema/schema-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extractor.d.ts","sourceRoot":"","sources":["../../src/schema/schema-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAK5E,uEAAuE;AACvE,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,2BAA2B;gBAErC,OAAO,EAAE,MAAM;CAK5B;AAMD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,QAAQ,CAAC,EAAE,aAAa,EAAE;IAKtC,2EAA2E;IAC3E,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAK7C,kEAAkE;IAClE,IAAI,YAAY,IAAI,MAAM,EAAE,CAE3B;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IASrC;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAShC;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAS1D,OAAO,CAAC,YAAY;CAGrB;AAED,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,iBAAwB,CAAC"}

package/dist/schema/schema-extractor.js

@@ -0,0 +1,89 @@
+import { TypeBoxAdapter } from './adapters/typebox.adapter.js';
+import { ZodAdapter } from './adapters/zod.adapter.js';
+import { JsonSchemaAdapter } from './adapters/json-schema.adapter.js';
+/** Thrown when no registered adapter can handle the provided input. */
+export class SchemaExtractionError extends Error {
+    name = 'SchemaExtractionError';
+    constructor(message) {
+        super(message);
+        // Restore the prototype chain when down-levelling or extending built-ins.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+const NO_MATCH = 'No adapter matched the provided input. ' +
+    'Provide a TypeBox schema, a Zod schema, or a plain JSON Schema object.';
+/**
+ * Delegates schema detection and conversion to a prioritised chain of
+ * {@link SchemaAdapter}s.
+ *
+ * Built-in adapters, tried in descending priority order:
+ *
+ * | Adapter            | Priority |
+ * |--------------------|----------|
+ * | TypeBoxAdapter     | 100      |
+ * | ZodAdapter         | 50       |
+ * | JsonSchemaAdapter  | 30       |
+ *
+ * Register your own with {@link registerAdapter}; it is inserted into the
+ * chain according to its `priority`.
+ */
+export class SchemaExtractor {
+    adapters;
+    constructor(adapters) {
+        this.adapters = adapters ?? [new TypeBoxAdapter(), new ZodAdapter(), new JsonSchemaAdapter()];
+        this.sortAdapters();
+    }
+    /** Add a custom adapter and re-sort the chain (highest priority first). */
+    registerAdapter(adapter) {
+        this.adapters.push(adapter);
+        this.sortAdapters();
+    }
+    /** Names of the adapters in the chain, highest priority first. */
+    get adapterNames() {
+        return this.adapters.map((adapter) => adapter.name);
+    }
+    /**
+     * Name of the first adapter that claims `input`, or `null` when none
+     * recognises it.
+     */
+    detect(input) {
+        for (const adapter of this.adapters) {
+            if (adapter.detect(input)) {
+                return adapter.name;
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract a TypeBox-compatible `TSchema` from `input`.
+     *
+     * @throws {SchemaExtractionError} When no adapter can handle the input.
+     */
+    extract(input) {
+        for (const adapter of this.adapters) {
+            if (adapter.detect(input)) {
+                return adapter.extract(input);
+            }
+        }
+        throw new SchemaExtractionError(NO_MATCH);
+    }
+    /**
+     * Extract a plain JSON Schema object from `input`.
+     *
+     * @throws {SchemaExtractionError} When no adapter can handle the input.
+     */
+    extractJsonSchema(input) {
+        for (const adapter of this.adapters) {
+            if (adapter.detect(input)) {
+                return adapter.extractJsonSchema(input);
+            }
+        }
+        throw new SchemaExtractionError(NO_MATCH);
+    }
+    sortAdapters() {
+        this.adapters.sort((a, b) => b.priority - a.priority);
+    }
+}
+/** Process-wide extractor used by the tool registrar and route scanner. */
+export const defaultSchemaExtractor = new SchemaExtractor();
+//# sourceMappingURL=schema-extractor.js.map

package/dist/schema/schema-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-extractor.js","sourceRoot":"","sources":["../../src/schema/schema-extractor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,uEAAuE;AACvE,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC5B,IAAI,GAAG,uBAAuB,CAAC;IAEjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,0EAA0E;QAC1E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,QAAQ,GACZ,yCAAyC;IACzC,wEAAwE,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAkB;IAElC,YAAY,QAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,CAAC,IAAI,cAAc,EAAE,EAAE,IAAI,UAAU,EAAE,EAAE,IAAI,iBAAiB,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,2EAA2E;IAC3E,eAAe,CAAC,OAAsB;QACpC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,kEAAkE;IAClE,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAc;QACnB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,IAAI,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAc;QACpB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,KAAc;QAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxD,CAAC;CACF;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/tools/define-tool.d.ts

@@ -0,0 +1,68 @@
+import type { ScannedModule } from 'apcore-toolkit';
+import { SchemaExtractor } from '../schema/schema-extractor.js';
+import type { BoundExecuteFn } from '../utils/module-factory.js';
+import type { ApToolDefinition, ApToolsetOptions } from '../types.js';
+/**
+ * Identity helper that gives a tool literal full type inference and a single
+ * obvious place to look for the shape.
+ *
+ * This is the Hono counterpart to NestJS's `@ApTool` decorator: Hono has no
+ * classes or DI container to decorate, so a tool is a plain object carrying
+ * its own metadata and handler.
+ *
+ * @example
+ * ```ts
+ * const listTodos = defineTool({
+ *   namespace: 'todo',
+ *   name: 'list',
+ *   description: 'List all todos',
+ *   inputSchema: Type.Object({ done: Type.Optional(Type.Boolean()) }),
+ *   annotations: { readonly: true, idempotent: true },
+ *   handler: (inputs) => ({ todos: store.filter(...) }),
+ * });
+ * ```
+ */
+export declare function defineTool(definition: ApToolDefinition): ApToolDefinition;
+/**
+ * Group several tools under one namespace, applying shared tags and
+ * annotations to each.
+ *
+ * The record key becomes the tool's `name` when the entry does not set one,
+ * so `{ list: {...} }` under namespace `todo` yields `todo.list`.
+ *
+ * @example
+ * ```ts
+ * const todoTools = defineToolset({
+ *   namespace: 'todo',
+ *   tags: ['todo'],
+ *   tools: {
+ *     list:   { description: 'List todos', handler: list },
+ *     create: { description: 'Add a todo', handler: create },
+ *   },
+ * });
+ * ```
+ */
+export declare function defineToolset(options: ApToolsetOptions): ApToolDefinition[];
+/** Resolve the module ID a tool definition will be registered under. */
+export declare function resolveToolId(tool: ApToolDefinition, modulePrefix?: string): string;
+/** Options for {@link toolToScannedModule}. */
+export interface ToolConversionOptions {
+    /** Prefix prepended to the generated module ID. */
+    modulePrefix?: string;
+    /** Extractor used for `inputSchema` / `outputSchema`. */
+    schemaExtractor?: SchemaExtractor;
+    /** Extra tags merged into the tool's own tags. */
+    tags?: string[];
+}
+/**
+ * Convert a {@link ApToolDefinition} into the toolkit's `ScannedModule`
+ * intermediate plus the bound execute function the registry needs.
+ *
+ * Schemas are normalised to JSON Schema, and JSDoc on the handler fills in
+ * missing documentation and per-parameter descriptions.
+ */
+export declare function toolToScannedModule(tool: ApToolDefinition, options?: ToolConversionOptions): {
+    module: ScannedModule;
+    execute: BoundExecuteFn;
+};
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/tools/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../../src/tools/define-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAA0B,MAAM,+BAA+B,CAAC;AAOxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,gBAAgB,GAAG,gBAAgB,CAEzE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAW3E;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBnF;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAiBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,qBAA0B,GAClC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAkCpD"}