@wp-typia/project-tools 0.24.4 → 0.24.5

package/dist/runtime/schema/typia-llm-types.d.ts

@@ -0,0 +1,197 @@
+import type { ArtifactSyncExecutionOptions, EndpointManifestDefinition, EndpointManifestEndpointDefinition } from '@wp-typia/block-runtime/metadata-core';
+import type { ILlmFunction, ILlmSchema, ILlmStructuredOutput } from 'typia';
+import type { EndpointAuthIntent, EndpointWordPressAuthDefinition, OpenApiDocument } from './schema-core.js';
+/**
+ * Method-level descriptor projected from an endpoint manifest for a generated
+ * `typia.llm` controller interface.
+ */
+export interface TypiaLlmEndpointMethodDescriptor {
+    /** Normalized auth intent derived from the endpoint manifest. */
+    authIntent: EndpointAuthIntent;
+    /** Optional auth mode propagated from legacy manifest metadata. */
+    authMode?: EndpointManifestEndpointDefinition['authMode'];
+    /** Human-readable operation summary. */
+    description?: string;
+    /** Input type used by the generated controller method, or null for no input. */
+    inputTypeName: string | null;
+    /** Type names that must be imported when inputTypeName is an inline composite. */
+    inputTypeImportNames?: readonly string[];
+    /** HTTP method from the source endpoint manifest. */
+    method: EndpointManifestEndpointDefinition['method'];
+    /** Stable operation identifier used as the generated method name. */
+    operationId: string;
+    /** Output type used by the generated controller method. */
+    outputTypeName: string;
+    /** REST path from the source endpoint manifest. */
+    path: string;
+    /** Tags copied from the source endpoint manifest. */
+    tags: readonly string[];
+    /** Optional WordPress auth overlay preserved for downstream adapters. */
+    wordpressAuth?: EndpointWordPressAuthDefinition;
+}
+/**
+ * Configures the generated TypeScript module that asks `typia.llm` to derive
+ * function-calling and structured-output artifacts from canonical contracts.
+ */
+export interface RenderTypiaLlmModuleOptions {
+    /** Export name for the generated `typia.llm.application<...>()` value. */
+    applicationExportName: string;
+    /** Generated controller interface name. */
+    interfaceName: string;
+    /** Endpoint manifest that owns REST operation metadata and source type names. */
+    manifest: EndpointManifestDefinition;
+    /** Export name for the generated `typia.llm.structuredOutput<...>()` value. */
+    structuredOutputExportName: string;
+    /** TypeScript output type used for structured-output projection. */
+    structuredOutputTypeName: string;
+    /** Import path from the generated module to the canonical TypeScript contracts. */
+    typesImportPath: string;
+}
+/**
+ * Configures writing or checking the generated `typia.llm` adapter module.
+ */
+export interface SyncTypiaLlmAdapterModuleOptions extends ArtifactSyncExecutionOptions, RenderTypiaLlmModuleOptions {
+    /** Destination path for the generated TypeScript adapter module. */
+    generatedSourceFile: string;
+}
+/**
+ * Describes the generated adapter module and where it was written or checked.
+ */
+export interface SyncTypiaLlmAdapterModuleResult {
+    /** True when the source file was only verified, false when it was written. */
+    check: boolean;
+    /** Generated endpoint method descriptors used by the module renderer. */
+    methodDescriptors: TypiaLlmEndpointMethodDescriptor[];
+    /** Rendered TypeScript module source. */
+    source: string;
+    /** Destination path for the generated TypeScript adapter module. */
+    sourceFile: string;
+}
+/**
+ * Function schema shape projected from a compiled `typia.llm.application(...)`
+ * result.
+ */
+export interface TypiaLlmFunctionLike extends Pick<ILlmFunction, 'description' | 'name' | 'output' | 'parameters'> {
+    /** Function description generated by `typia.llm`. */
+    description?: string;
+    /** Function name generated by `typia.llm`. */
+    name: string;
+    /** Optional output schema generated by `typia.llm`. */
+    output?: ILlmSchema.IParameters;
+    /** Function parameter schema generated by `typia.llm`. */
+    parameters: ILlmSchema.IParameters;
+    /** Optional tags generated by `typia.llm`. */
+    tags?: readonly string[];
+}
+/**
+ * Application shape projected from a compiled `typia.llm.application(...)`
+ * result.
+ */
+export interface TypiaLlmApplicationLike {
+    /** Function schemas generated by `typia.llm`. */
+    functions: readonly TypiaLlmFunctionLike[];
+}
+/**
+ * Structured-output shape projected from a compiled
+ * `typia.llm.structuredOutput(...)` result.
+ */
+export interface TypiaLlmStructuredOutputLike extends Pick<ILlmStructuredOutput, 'parameters'> {
+    /** Structured output parameters generated by `typia.llm`. */
+    parameters: ILlmStructuredOutput['parameters'];
+}
+/**
+ * JSON-friendly function artifact for downstream adapter consumers.
+ */
+export interface ProjectedTypiaLlmFunctionArtifact {
+    /** Function description generated by `typia.llm`. */
+    description?: string;
+    /** Function name generated by `typia.llm`. */
+    name: string;
+    /** Optional output schema generated by `typia.llm`. */
+    output?: ILlmSchema.IParameters;
+    /** Function parameter schema generated by `typia.llm`. */
+    parameters: ILlmSchema.IParameters;
+    /** Optional tags generated by `typia.llm`. */
+    tags?: string[];
+}
+/**
+ * JSON-friendly application artifact for downstream adapter consumers.
+ */
+export interface ProjectedTypiaLlmApplicationArtifact {
+    /** Function-calling artifacts generated by `typia.llm`. */
+    functions: ProjectedTypiaLlmFunctionArtifact[];
+    /** Source metadata that keeps the artifact tied to canonical contracts. */
+    generatedFrom: {
+        baselineOpenApiPath?: string;
+        blockSlug: string;
+        manifestSource: 'endpoint-manifest+typescript';
+    };
+}
+/**
+ * JSON-friendly structured-output artifact for downstream adapter consumers.
+ */
+export interface ProjectedTypiaLlmStructuredOutputArtifact {
+    /** Source metadata that keeps the artifact tied to canonical contracts. */
+    generatedFrom: {
+        aiSchemaPath?: string;
+        blockSlug: string;
+        outputTypeName: string;
+    };
+    /** Structured output parameters generated by `typia.llm`. */
+    parameters: ILlmStructuredOutput['parameters'];
+}
+/**
+ * Configures optional OpenAPI-backed constraint restoration for projected
+ * `typia.llm` function artifacts.
+ */
+export interface ProjectTypiaLlmOpenApiProjectionOptions {
+    /** Canonical endpoint-aware OpenAPI document for the projected contracts. */
+    openApiDocument: OpenApiDocument;
+    /** Optional override for resolving one function schema to an operation id. */
+    resolveOperationId?: (functionSchema: TypiaLlmFunctionLike, functionArtifact: ProjectedTypiaLlmFunctionArtifact) => string;
+}
+/**
+ * Configures projection of a compiled `typia.llm.application(...)` result into
+ * the JSON-friendly adapter artifact.
+ */
+export interface ProjectTypiaLlmApplicationArtifactOptions {
+    /** Compiled application value produced by `typia.llm.application(...)`. */
+    application: TypiaLlmApplicationLike;
+    /** Source metadata for the generated JSON artifact. */
+    generatedFrom: ProjectedTypiaLlmApplicationArtifact['generatedFrom'];
+    /** Optional OpenAPI projection that restores canonical schema constraints. */
+    openApiProjection?: ProjectTypiaLlmOpenApiProjectionOptions;
+    /** Optional hook for adapter-specific function schema normalization. */
+    transformFunction?: (functionArtifact: ProjectedTypiaLlmFunctionArtifact, functionSchema: TypiaLlmFunctionLike) => ProjectedTypiaLlmFunctionArtifact;
+}
+/**
+ * Configures direct OpenAPI-backed constraint restoration for one projected
+ * function artifact.
+ */
+export interface ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions {
+    /** Projected function artifact to enrich with canonical constraints. */
+    functionArtifact: ProjectedTypiaLlmFunctionArtifact;
+    /** Canonical endpoint-aware OpenAPI document. */
+    openApiDocument: OpenApiDocument;
+    /** Operation id that owns the request/response contract for this function. */
+    operationId: string;
+}
+/**
+ * Configures projection of a compiled `typia.llm.structuredOutput(...)` result
+ * into the JSON-friendly adapter artifact.
+ */
+export interface ProjectTypiaLlmStructuredOutputArtifactOptions {
+    /** Source metadata for the generated JSON artifact. */
+    generatedFrom: ProjectedTypiaLlmStructuredOutputArtifact['generatedFrom'];
+    /** Compiled structured-output value produced by `typia.llm.structuredOutput(...)`. */
+    structuredOutput: TypiaLlmStructuredOutputLike;
+}
+/**
+ * Generated Typia LLM artifact payload and destination.
+ */
+export type GeneratedTypiaLlmArtifactFile = {
+    /** File contents to write or compare. */
+    content: string;
+    /** Destination path for the generated artifact file. */
+    filePath: string;
+};

package/dist/runtime/schema/typia-llm-types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/schema/typia-llm.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Public compatibility facade for Typia LLM runtime helpers.
+ *
+ * Keep `@wp-typia/project-tools/typia-llm` stable while rendering, sync,
+ * projection, and OpenAPI constraint restoration live in focused modules.
+ */
+export type { ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions, ProjectedTypiaLlmApplicationArtifact, ProjectedTypiaLlmFunctionArtifact, ProjectedTypiaLlmStructuredOutputArtifact, ProjectTypiaLlmApplicationArtifactOptions, ProjectTypiaLlmOpenApiProjectionOptions, ProjectTypiaLlmStructuredOutputArtifactOptions, RenderTypiaLlmModuleOptions, SyncTypiaLlmAdapterModuleOptions, SyncTypiaLlmAdapterModuleResult, TypiaLlmApplicationLike, TypiaLlmEndpointMethodDescriptor, TypiaLlmFunctionLike, TypiaLlmStructuredOutputLike, } from './typia-llm-types.js';
+export { assertJsonSchemaObject } from './typia-llm-json-schema.js';
+export { applyOpenApiConstraintsToTypiaLlmFunctionArtifact, } from './typia-llm-openapi-constraints.js';
+export { projectTypiaLlmApplicationArtifact, projectTypiaLlmApplicationFunction, projectTypiaLlmStructuredOutputArtifact, } from './typia-llm-projection.js';
+export { buildTypiaLlmEndpointMethodDescriptors, renderTypiaLlmModule, } from './typia-llm-render.js';
+export { syncTypiaLlmAdapterModule } from './typia-llm-sync.js';

package/dist/runtime/schema/typia-llm.js

@@ -0,0 +1,5 @@
+export { assertJsonSchemaObject } from './typia-llm-json-schema.js';
+export { applyOpenApiConstraintsToTypiaLlmFunctionArtifact, } from './typia-llm-openapi-constraints.js';
+export { projectTypiaLlmApplicationArtifact, projectTypiaLlmApplicationFunction, projectTypiaLlmStructuredOutputArtifact, } from './typia-llm-projection.js';
+export { buildTypiaLlmEndpointMethodDescriptors, renderTypiaLlmModule, } from './typia-llm-render.js';
+export { syncTypiaLlmAdapterModule } from './typia-llm-sync.js';

package/dist/runtime/schema/typia-tags.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runtime/schema/typia-tags.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/schema/wordpress-ai.d.ts

@@ -0,0 +1,122 @@
+import type { EndpointManifestDefinition, EndpointManifestEndpointDefinition } from '@wp-typia/block-runtime/metadata-core';
+import { type EndpointAuthIntent, type EndpointWordPressAuthDefinition, type JsonSchemaDocument } from './schema-core.js';
+import { type AbilitySpecCatalog } from '../add/ability-spec.js';
+export type { AbilityAnnotationSpec, AbilityCategorySpec, AbilityMcpProjectionSpec, AbilityMetaSpec, AbilitySpec, AbilitySpecCatalog, } from '../add/ability-spec.js';
+/**
+ * Represents one projected WordPress-native ability derived from an endpoint
+ * manifest plus an AbilitySpec definition.
+ */
+export interface ProjectedWordPressAbilityDefinition {
+    /** Normalized auth intent derived from the endpoint manifest. */
+    authIntent: EndpointAuthIntent;
+    /** Optional auth mode propagated from the manifest when present. */
+    authMode?: EndpointManifestEndpointDefinition['authMode'];
+    /** Shared category identifier resolved from the AbilitySpec catalog. */
+    category: string;
+    /** Human-readable summary shown to ability discovery consumers. */
+    description: string;
+    /** PHP callback that executes the ability. */
+    executeCallback: string;
+    /** Stable generated ability identifier. */
+    id: string;
+    /** Optional projected input schema, or null when no input exists. */
+    inputSchema: Record<string, unknown> | null;
+    /** Display label propagated from the AbilitySpec layer. */
+    label: string;
+    /** WordPress-owned metadata preserved in the projected document. */
+    meta: Record<string, unknown>;
+    /** HTTP method from the source endpoint manifest. */
+    method: EndpointManifestEndpointDefinition['method'];
+    /** Source operation identifier from the endpoint manifest. */
+    operationId: string;
+    /** Projected AI response schema shared by the document. */
+    outputSchema: Record<string, unknown>;
+    /** HTTP path from the source endpoint manifest. */
+    path: string;
+    /** PHP permission callback that gates the ability. */
+    permissionCallback: string;
+    /** Optional WordPress auth metadata preserved for downstream adapters. */
+    wordpressAuth?: EndpointWordPressAuthDefinition;
+}
+/**
+ * Bundles a single-category WordPress AI abilities document together with the
+ * metadata that describes how it was generated.
+ */
+export interface ProjectedWordPressAbilitiesDocument {
+    /** Ability definitions generated from the current manifest and AbilitySpec map. */
+    abilities: ProjectedWordPressAbilityDefinition[];
+    /** Shared category metadata for the generated document. */
+    category: {
+        id: string;
+        label: string;
+    };
+    /** Source metadata that points downstream consumers at the generated schema. */
+    generatedFrom: {
+        blockSlug: string;
+        responseSchemaPath: string;
+        schemaProfile: 'ai-structured-output';
+    };
+}
+/**
+ * Carries the projected input schema plus endpoint metadata into an optional
+ * transform hook.
+ */
+export interface WordPressAiInputSchemaTransformContext {
+    /** Name of the input contract being transformed. */
+    contractName: string;
+    /** Source endpoint that requested the input schema. */
+    endpoint: EndpointManifestEndpointDefinition;
+    /** Already-projected AI-friendly input schema. */
+    schema: JsonSchemaDocument & Record<string, unknown>;
+}
+interface BuildWordPressAbilitiesDocumentOptions {
+    abilityCatalog: AbilitySpecCatalog;
+    buildAbilityId?: (operationId: string) => string;
+    generatedFrom: ProjectedWordPressAbilitiesDocument['generatedFrom'];
+    loadInputSchema?: (endpoint: EndpointManifestEndpointDefinition, contractName: string) => Promise<JsonSchemaDocument & Record<string, unknown>>;
+    manifest: EndpointManifestDefinition;
+    outputSchema: Record<string, unknown>;
+    transformInputSchema?: (context: WordPressAiInputSchemaTransformContext) => JsonSchemaDocument & Record<string, unknown>;
+}
+interface BuildWordPressAiArtifactsOptions extends Omit<BuildWordPressAbilitiesDocumentOptions, 'outputSchema'> {
+    responseSchema: JsonSchemaDocument & Record<string, unknown>;
+}
+/**
+ * Projects a canonical schema into the AI structured-output profile used by
+ * WordPress AI artifact generation.
+ *
+ * @param schema Canonical JSON Schema document from the manifest-owned source.
+ * @returns The projected AI-friendly schema document.
+ */
+export declare function projectWordPressAiSchema(schema: JsonSchemaDocument & Record<string, unknown>): JsonSchemaDocument & Record<string, unknown>;
+/**
+ * Builds a WordPress abilities document from a manifest-first REST surface and
+ * a matching AbilitySpec catalog.
+ *
+ * Input schemas are loaded lazily per endpoint only when an input contract
+ * exists, and `transformInputSchema` runs after the schema has already been
+ * projected into the AI structured-output profile.
+ *
+ * @param options Manifest, ability catalog, and projected output schema inputs.
+ * @returns The generated WordPress abilities document.
+ * @throws When an endpoint is missing an AbilitySpec.
+ * @throws When categories are missing, inconsistent, or span multiple documents.
+ * @throws When an endpoint references a missing input contract or no loader was supplied.
+ */
+export declare function buildWordPressAbilitiesDocument({ abilityCatalog, buildAbilityId, generatedFrom, loadInputSchema, manifest, outputSchema, transformInputSchema, }: BuildWordPressAbilitiesDocumentOptions): Promise<ProjectedWordPressAbilitiesDocument>;
+/**
+ * Builds the projected AI response schema together with its companion
+ * WordPress abilities document.
+ *
+ * All endpoints must share the same response contract and category so the
+ * generated artifacts stay aligned with one manifest-owned response surface.
+ *
+ * @param options Manifest, ability catalog, and response schema inputs.
+ * @returns The projected AI response schema and generated abilities document.
+ * @throws When the manifest has no endpoints.
+ * @throws When the shared response contract is missing or inconsistent.
+ */
+export declare function buildWordPressAiArtifacts({ abilityCatalog, buildAbilityId, generatedFrom, loadInputSchema, manifest, responseSchema, transformInputSchema, }: BuildWordPressAiArtifactsOptions): Promise<{
+    abilitiesDocument: ProjectedWordPressAbilitiesDocument;
+    aiResponseSchema: Record<string, unknown>;
+}>;

package/dist/runtime/schema/wordpress-ai.js

@@ -0,0 +1,177 @@
+import { normalizeEndpointAuthDefinition, projectJsonSchemaDocument, } from './schema-core.js';
+import { resolveAbilityCategorySpec, } from '../add/ability-spec.js';
+function getEndpointInputContractName(endpoint) {
+    if (endpoint.method !== 'GET' &&
+        endpoint.bodyContract &&
+        endpoint.queryContract) {
+        throw new Error(`Endpoint "${endpoint.operationId}" defines both bodyContract and queryContract; WordPress AI input projection is ambiguous.`);
+    }
+    if (endpoint.method === 'GET') {
+        return endpoint.queryContract ?? null;
+    }
+    return endpoint.bodyContract ?? endpoint.queryContract ?? null;
+}
+function toAbilityId(categoryId, operationId) {
+    return `${categoryId}/${operationId
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .toLowerCase()}`;
+}
+/**
+ * Projects a canonical schema into the AI structured-output profile used by
+ * WordPress AI artifact generation.
+ *
+ * @param schema Canonical JSON Schema document from the manifest-owned source.
+ * @returns The projected AI-friendly schema document.
+ */
+export function projectWordPressAiSchema(schema) {
+    return projectJsonSchemaDocument(schema, {
+        profile: 'ai-structured-output',
+    });
+}
+function assertAbilityMetaKeys(abilitySpec, operationId) {
+    if (!abilitySpec.meta) {
+        return;
+    }
+    if ('annotations' in abilitySpec.meta) {
+        throw new Error(`Operation "${operationId}" cannot set AbilitySpec.meta.annotations directly; use AbilitySpec.annotations instead.`);
+    }
+    if ('show_in_rest' in abilitySpec.meta) {
+        throw new Error(`Operation "${operationId}" cannot set AbilitySpec.meta.show_in_rest directly; use AbilitySpec.showInRest instead.`);
+    }
+}
+/**
+ * Builds a WordPress abilities document from a manifest-first REST surface and
+ * a matching AbilitySpec catalog.
+ *
+ * Input schemas are loaded lazily per endpoint only when an input contract
+ * exists, and `transformInputSchema` runs after the schema has already been
+ * projected into the AI structured-output profile.
+ *
+ * @param options Manifest, ability catalog, and projected output schema inputs.
+ * @returns The generated WordPress abilities document.
+ * @throws When an endpoint is missing an AbilitySpec.
+ * @throws When categories are missing, inconsistent, or span multiple documents.
+ * @throws When an endpoint references a missing input contract or no loader was supplied.
+ */
+export async function buildWordPressAbilitiesDocument({ abilityCatalog, buildAbilityId, generatedFrom, loadInputSchema, manifest, outputSchema, transformInputSchema, }) {
+    const resolvedEndpoints = manifest.endpoints.map((endpoint) => {
+        const abilitySpec = abilityCatalog.abilities[endpoint.operationId];
+        if (!abilitySpec) {
+            throw new Error(`Missing AbilitySpec for operationId "${endpoint.operationId}".`);
+        }
+        assertAbilityMetaKeys(abilitySpec, endpoint.operationId);
+        return {
+            abilitySpec,
+            category: resolveAbilityCategorySpec(abilitySpec, abilityCatalog.categories, endpoint.operationId),
+            endpoint,
+        };
+    });
+    const documentCategory = resolvedEndpoints[0]?.category ?? null;
+    if (!documentCategory) {
+        throw new Error('WordPress AI projection requires at least one endpoint before it can resolve an AbilitySpec category.');
+    }
+    for (const resolvedEndpoint of resolvedEndpoints) {
+        if (resolvedEndpoint.category.id !== documentCategory.id) {
+            throw new Error(`Operation "${resolvedEndpoint.endpoint.operationId}" uses AbilitySpec category "${resolvedEndpoint.category.id}" but WordPress AI projections currently support one shared category per document.`);
+        }
+    }
+    const abilities = await Promise.all(resolvedEndpoints.map(async ({ abilitySpec, category, endpoint }) => {
+        const inputContractName = getEndpointInputContractName(endpoint);
+        let inputSchema = null;
+        if (inputContractName) {
+            if (!manifest.contracts[inputContractName]) {
+                throw new Error(`Endpoint "${endpoint.operationId}" references missing input contract "${inputContractName}".`);
+            }
+            if (!loadInputSchema) {
+                throw new Error(`Missing input schema loader for operationId "${endpoint.operationId}".`);
+            }
+            const projectedInputSchema = projectWordPressAiSchema(await loadInputSchema(endpoint, inputContractName));
+            inputSchema = transformInputSchema
+                ? transformInputSchema({
+                    contractName: inputContractName,
+                    endpoint,
+                    schema: projectedInputSchema,
+                })
+                : projectedInputSchema;
+        }
+        const normalizedAuth = normalizeEndpointAuthDefinition(endpoint);
+        return {
+            authIntent: normalizedAuth.auth,
+            ...(normalizedAuth.authMode
+                ? { authMode: normalizedAuth.authMode }
+                : {}),
+            category: category.id,
+            description: endpoint.summary ?? abilitySpec.label,
+            executeCallback: abilitySpec.executeCallback,
+            id: (buildAbilityId ??
+                ((operationId) => toAbilityId(category.id, operationId)))(endpoint.operationId),
+            inputSchema,
+            label: abilitySpec.label,
+            meta: {
+                ...(abilitySpec.meta ?? {}),
+                ...(abilitySpec.annotations
+                    ? {
+                        annotations: abilitySpec.annotations,
+                    }
+                    : {}),
+                show_in_rest: abilitySpec.showInRest ?? true,
+            },
+            method: endpoint.method,
+            operationId: endpoint.operationId,
+            outputSchema,
+            path: endpoint.path,
+            permissionCallback: abilitySpec.permissionCallback,
+            ...(normalizedAuth.wordpressAuth
+                ? { wordpressAuth: normalizedAuth.wordpressAuth }
+                : {}),
+        };
+    }));
+    return {
+        abilities,
+        category: documentCategory,
+        generatedFrom,
+    };
+}
+/**
+ * Builds the projected AI response schema together with its companion
+ * WordPress abilities document.
+ *
+ * All endpoints must share the same response contract and category so the
+ * generated artifacts stay aligned with one manifest-owned response surface.
+ *
+ * @param options Manifest, ability catalog, and response schema inputs.
+ * @returns The projected AI response schema and generated abilities document.
+ * @throws When the manifest has no endpoints.
+ * @throws When the shared response contract is missing or inconsistent.
+ */
+export async function buildWordPressAiArtifacts({ abilityCatalog, buildAbilityId, generatedFrom, loadInputSchema, manifest, responseSchema, transformInputSchema, }) {
+    if (manifest.endpoints.length === 0) {
+        throw new Error('WordPress AI projection requires at least one endpoint in the manifest.');
+    }
+    const responseContractName = manifest.endpoints[0].responseContract;
+    if (!responseContractName) {
+        throw new Error('The manifest is missing its shared response contract.');
+    }
+    for (const endpoint of manifest.endpoints) {
+        if (endpoint.responseContract !== responseContractName) {
+            throw new Error(`Endpoint "${endpoint.operationId}" uses response contract "${endpoint.responseContract}" but expected shared response contract "${responseContractName}".`);
+        }
+    }
+    if (!manifest.contracts[responseContractName]) {
+        throw new Error(`The manifest references missing response contract "${responseContractName}".`);
+    }
+    const aiResponseSchema = projectWordPressAiSchema(responseSchema);
+    const abilitiesDocument = await buildWordPressAbilitiesDocument({
+        abilityCatalog,
+        buildAbilityId,
+        generatedFrom,
+        loadInputSchema,
+        manifest,
+        outputSchema: aiResponseSchema,
+        transformInputSchema,
+    });
+    return {
+        abilitiesDocument,
+        aiResponseSchema,
+    };
+}

package/dist/runtime/schema-core.d.ts

@@ -1,7 +1 @@
-/**
- * Re-exports schema and OpenAPI helpers from `@wp-typia/block-runtime`.
- * This adapter preserves the public `@wp-typia/project-tools/schema-core`
- * path while sharing the canonical implementation with block-runtime.
- * @module
- */
-export * from "@wp-typia/block-runtime/schema-core";
+export * from "./schema/schema-core.js";

package/dist/runtime/schema-core.js

@@ -1,7 +1 @@
-/**
- * Re-exports schema and OpenAPI helpers from `@wp-typia/block-runtime`.
- * This adapter preserves the public `@wp-typia/project-tools/schema-core`
- * path while sharing the canonical implementation with block-runtime.
- * @module
- */
-export * from "@wp-typia/block-runtime/schema-core";
+export * from "./schema/schema-core.js";

package/dist/runtime/shared/fs-async.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Return whether a filesystem path exists without blocking the event loop.
+ *
+ * @param filePath Absolute or relative path to check.
+ * @returns `true` when the path can be accessed, otherwise `false`.
+ */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/**
+ * Read a UTF-8 file when it exists and otherwise return `null`.
+ *
+ * @param filePath Absolute or relative file path to read.
+ * @returns The UTF-8 source, or `null` when the file is missing.
+ */
+export declare function readOptionalUtf8File(filePath: string): Promise<string | null>;
+/**
+ * Extract a Node.js error code from an unknown thrown value.
+ *
+ * @param error Unknown error value.
+ * @returns The string error code, or an empty string when unavailable.
+ */
+export declare function getNodeErrorCode(error: unknown): string;
+/**
+ * Extract a Node.js error code from an unknown thrown value when available.
+ *
+ * @param error Unknown error value.
+ * @returns The string error code, or `undefined` when unavailable.
+ */
+export declare function getOptionalNodeErrorCode(error: unknown): string | undefined;
+/**
+ * Return whether an unknown error represents a missing filesystem path.
+ *
+ * @param error Unknown error value.
+ * @returns `true` when the error has Node.js code `ENOENT`.
+ */
+export declare function isFileNotFoundError(error: unknown): boolean;

package/dist/runtime/shared/fs-async.js

@@ -0,0 +1,62 @@
+import { promises as fsp } from "node:fs";
+/**
+ * Return whether a filesystem path exists without blocking the event loop.
+ *
+ * @param filePath Absolute or relative path to check.
+ * @returns `true` when the path can be accessed, otherwise `false`.
+ */
+export async function pathExists(filePath) {
+    try {
+        await fsp.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read a UTF-8 file when it exists and otherwise return `null`.
+ *
+ * @param filePath Absolute or relative file path to read.
+ * @returns The UTF-8 source, or `null` when the file is missing.
+ */
+export async function readOptionalUtf8File(filePath) {
+    try {
+        return await fsp.readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isFileNotFoundError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Extract a Node.js error code from an unknown thrown value.
+ *
+ * @param error Unknown error value.
+ * @returns The string error code, or an empty string when unavailable.
+ */
+export function getNodeErrorCode(error) {
+    return getOptionalNodeErrorCode(error) ?? "";
+}
+/**
+ * Extract a Node.js error code from an unknown thrown value when available.
+ *
+ * @param error Unknown error value.
+ * @returns The string error code, or `undefined` when unavailable.
+ */
+export function getOptionalNodeErrorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+}
+/**
+ * Return whether an unknown error represents a missing filesystem path.
+ *
+ * @param error Unknown error value.
+ * @returns `true` when the error has Node.js code `ENOENT`.
+ */
+export function isFileNotFoundError(error) {
+    return getOptionalNodeErrorCode(error) === "ENOENT";
+}

package/dist/runtime/shared/id-suggestions.d.ts

@@ -0,0 +1,21 @@
+export interface SuggestCloseIdOptions {
+    /**
+     * Maximum edit distance accepted for a suggestion.
+     *
+     * Defaults to `2`, matching the create-template typo guard.
+     */
+    maxDistance?: number;
+    /**
+     * Normalizes user input and candidates before comparing them.
+     *
+     * Defaults to trimming and lowercasing for CLI id-like values.
+     */
+    normalize?: (value: string) => string;
+}
+/**
+ * Suggest the closest known id for a user-provided CLI value.
+ *
+ * This helper is intentionally generic so command-specific validation can keep
+ * its own wording and special-case handling while sharing typo thresholds.
+ */
+export declare function suggestCloseId<const TCandidate extends string>(input: string, candidates: readonly TCandidate[], options?: SuggestCloseIdOptions): TCandidate | null;