kizlo 0.21.0 → 0.22.0

package/dist/cli/mcp/server.js

@@ -1,5 +1,5 @@
 import { log } from "../daemon/logger.js";
-import { callRoute, describeRoute, listRoutes } from "./tools.js";
+import { callRoute, describeRoute, searchRoutes } from "./tools.js";
 import z from "zod/v4";
 import { createServer } from "node:http";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -38,21 +38,92 @@ function isAllowedOrigin(origin) {
 		return false;
 	}
 }
-/** Render a tool's answer as the MCP content block a client reads, failures included. */
-function toolContent(result) {
+/**
+* Render a tool's answer for both kinds of reader: `structuredContent` for a client that parses, and
+* a text block for one that does not.
+*
+* A failure carries no `structuredContent`. A client validates whatever it finds there against the
+* tool's declared output schema whether or not the result is an error, and a failure is not that
+* shape, so putting it there makes a client reject the answer outright instead of reading it. The
+* detail rides in a second text block, which keeps it machine-readable without breaking the contract.
+*/
+function toolContent(result, summarize = (value) => JSON.stringify(value, null, 2)) {
 	if (!result.ok) return {
 		content: [{
 			type: "text",
-			text: result.error
+			text: result.error.message
+		}, {
+			type: "text",
+			text: JSON.stringify(result.error, null, 2)
 		}],
 		isError: true
 	};
-	return { content: [{
-		type: "text",
-		text: JSON.stringify(result.value, null, 2)
-	}] };
+	return {
+		content: [{
+			type: "text",
+			text: summarize(result.value)
+		}],
+		structuredContent: result.value
+	};
 }
 /**
+* The one result long enough to be worth compressing. Describe and call put their payload in the
+* text block because the payload is the answer; a ranked list is better read than parsed.
+*/
+function summarizeSearch(value) {
+	const outcome = value;
+	if (outcome.count === 0) return outcome.message ?? "No route matches that search.";
+	const lines = outcome.routes.map((route) => {
+		const evidence = route.evidence.map((item) => `${item.field}:${item.term}`).join(", ");
+		const summary = route.summary === void 0 ? "" : ` — ${route.summary}`;
+		const deprecated = route.deprecated ? " (deprecated)" : "";
+		return `${route.name} — ${route.method} ${route.path}${summary}${deprecated}${evidence === "" ? "" : ` [${evidence}]`}`;
+	});
+	const more = outcome.nextCursor === void 0 ? "" : `\n${outcome.count - outcome.routes.length} more. Pass cursor "${outcome.nextCursor}" for the next page.`;
+	return `${outcome.count} route${outcome.count === 1 ? "" : "s"} match:\n${lines.join("\n")}${more}`;
+}
+/** A ranked result, and the named part of the contract that selected it. */
+const SEARCH_OUTPUT = {
+	count: z.number().describe("Matches across the whole catalog, not just this page."),
+	routes: z.array(z.object({
+		name: z.string(),
+		namespace: z.string(),
+		method: z.string(),
+		path: z.string(),
+		summary: z.string().optional(),
+		deprecated: z.literal(true).optional(),
+		evidence: z.array(z.object({
+			field: z.string(),
+			term: z.string()
+		}))
+	})),
+	namespaces: z.array(z.string()).describe("Every REST namespace this WordPress serves."),
+	nextCursor: z.string().optional().describe("Hand back as `cursor` to read the next page."),
+	message: z.string().optional().describe("Present only when nothing matched.")
+};
+const DESCRIBE_OUTPUT = {
+	name: z.string(),
+	namespace: z.string(),
+	method: z.string(),
+	path: z.string(),
+	summary: z.string().optional(),
+	description: z.string().optional(),
+	deprecated: z.literal(true).optional(),
+	pathParameters: z.array(z.string()),
+	input: z.record(z.string(), z.unknown()).describe("JSON Schema for `{ params, query, body }`, with its `$defs`."),
+	responses: z.record(z.string(), z.unknown()).describe("Keyed by HTTP status."),
+	errors: z.array(z.string()).describe("Error codes this route declares.")
+};
+/**
+* Deliberately permissive. The SDK validates `structuredContent` against this on every successful
+* call, so anything narrower would turn a route whose response does not fit into a protocol error
+* rather than an answer.
+*/
+const CALL_OUTPUT = {
+	status: z.number(),
+	data: z.unknown().optional()
+};
+/**
 * Three dispatchers rather than a tool per route. The contract a seeded WordPress serves runs to well
 * over a hundred routes, and putting their schemas in front of a model up front would cost tens of
 * thousands of tokens in every message. These cost a few hundred and reach all of them — and because
@@ -63,24 +134,44 @@ function createMcpServer(state) {
 	const server = new McpServer({
 		name: "kizlo",
 		version: "1.0.0"
-	}, { instructions: "Read and call the WordPress REST routes of the Kizlo project this server was started in." });
-	server.registerTool("kizlo_list_routes", {
-		title: "List WordPress routes",
-		description: "List every REST route this project's WordPress serves, with its method and summary. Start here: the route names it returns are what `kizlo_describe_route` and `kizlo_call` take.",
-		inputSchema: { namespace: z.string().optional().describe("Only routes in this REST namespace, e.g. \"wp/v2\" or \"kizlo/v1\".") }
-	}, async ({ namespace }) => toolContent(listRoutes(state, namespace === void 0 ? {} : { namespace })));
+	}, { instructions: [
+		"Read and change the WordPress of the Kizlo project this server was started in.",
+		"Every REST route that WordPress exposes is reachable here — core, Kizlo's own, and any plugin's — through three tools rather than one tool per route.",
+		"Work in that order: `kizlo_search_routes` to find a route, `kizlo_describe_route` to read its contract, `kizlo_call` to run it.",
+		"Describe a route before calling it unless you already know its contract. Arguments are grouped into `params`, `query`, and `body`, and the description says which fields belong where.",
+		"API errors are passed through unchanged: the code, message, and data are WordPress's own, not this server's summary of them."
+	].join(" ") });
+	server.registerTool("kizlo_search_routes", {
+		title: "Search WordPress routes",
+		description: "Find routes by identity or by meaning: a route name, path, or namespace, or terms from a route's arguments, response fields, description, or error codes. Start here. Omit `query` to browse the whole catalog. Each result names the evidence that selected it, and the route names it returns are what `kizlo_describe_route` and `kizlo_call` take.",
+		inputSchema: {
+			query: z.string().optional().describe("Terms to rank on. Omit or leave empty to browse every route."),
+			namespace: z.string().optional().describe("Only routes in this REST namespace, e.g. \"wp/v2\" or \"kizlo/v1\"."),
+			method: z.string().optional().describe("Only routes served with this HTTP method, e.g. \"GET\"."),
+			access: z.enum(["read", "write"]).optional().describe("Only reading routes (GET, HEAD, OPTIONS) or only writing ones."),
+			limit: z.number().int().optional().describe("Results per page. Defaults to 20, at most 100."),
+			cursor: z.string().optional().describe("The `nextCursor` from a previous search, to read the next page.")
+		},
+		outputSchema: SEARCH_OUTPUT
+	}, async (input) => toolContent(searchRoutes(state, input), summarizeSearch));
 	server.registerTool("kizlo_describe_route", {
 		title: "Describe a WordPress route",
-		description: "The JSON Schema for one route's arguments, plus which of them are interpolated into its path.",
-		inputSchema: { route: z.string().describe("A route name from `kizlo_list_routes`, e.g. `postTypes.book.list`.") }
+		description: "The complete contract for one route: the JSON Schema for its `params`, `query`, and `body`, with the definitions they reference; the response schema for each HTTP status, with content types and headers; which arguments are interpolated into the path; and the error codes the route declares.",
+		inputSchema: { route: z.string().describe("A route name from `kizlo_search_routes`, e.g. `kizlo.postTypes.book.list`.") },
+		outputSchema: DESCRIBE_OUTPUT
 	}, async ({ route }) => toolContent(describeRoute(state, { route })));
 	server.registerTool("kizlo_call", {
 		title: "Call a WordPress route",
-		description: "Run one route against this project's WordPress and return its response. Path parameters, query parameters, and body fields all go in `input`; `kizlo_describe_route` says which are which.",
+		description: "Run one route against this project's WordPress and return its response. Arguments go in `input` under the part they belong to: `params` for the values interpolated into the path, `query` for query parameters, and `body` for the payload. `kizlo_describe_route` says which are which.",
 		inputSchema: {
-			route: z.string().describe("A route name from `kizlo_list_routes`."),
-			input: z.record(z.string(), z.unknown()).optional().describe("The route's arguments, as described by `kizlo_describe_route`.")
-		}
+			route: z.string().describe("A route name from `kizlo_search_routes`."),
+			input: z.object({
+				params: z.record(z.string(), z.unknown()).optional().describe("Values interpolated into the path."),
+				query: z.record(z.string(), z.unknown()).optional().describe("Query parameters."),
+				body: z.unknown().optional().describe("The request payload.")
+			}).optional().describe("The route's arguments, grouped as `kizlo_describe_route` describes them.")
+		},
+		outputSchema: CALL_OUTPUT
 	}, async ({ route, input }) => toolContent(await callRoute(state, input === void 0 ? { route } : {
 		route,
 		input

package/dist/cli/mcp/tools.js

@@ -1,52 +1,54 @@
 import { buildWordPressRequest } from "../../wordpress/endpoint.js";
 import { WordPressTransport } from "../../wordpress/transport.js";
-import { routesOf, sortRoutes } from "./routes.js";
-import { toJsonSchema } from "./schema.js";
+import { routesOf } from "./routes.js";
+import { inputJsonSchema, toJsonSchema } from "./schema.js";
+import { searchRoutes } from "./search.js";
 
 //#region src/cli/mcp/tools.ts
 /** The document is fetched by the watcher, so the only reason it is missing is that none has arrived yet. */
 const NO_DOCUMENT = "The WordPress contract has not been fetched yet. Retry in a moment; `kizlo dev` refreshes it every few seconds.";
-/** Summaries only. The schemas behind these routes are far too large to put in front of a model at once. */
-function listRoutes(state, input = {}) {
-	if (!state.document) return {
+function failed(message) {
+	return {
 		ok: false,
-		error: NO_DOCUMENT
+		error: {
+			kind: "request",
+			message
+		}
 	};
-	const all = sortRoutes(routesOf(state.document).values());
-	const routes = input.namespace ? all.filter((route) => route.namespace === input.namespace) : all;
-	if (input.namespace && routes.length === 0) {
-		const known = [...new Set(all.map((route) => route.namespace))].sort();
+}
+/**
+* Rank the routes this WordPress serves against a query, or browse them all when there is none.
+*
+* Summaries and match evidence only. The schemas behind these routes are far too large to put in
+* front of a model at once, which is what `kizlo_describe_route` is for.
+*/
+function searchRoutes$1(state, input = {}) {
+	if (!state.document) return failed(NO_DOCUMENT);
+	const outcome = searchRoutes(state.document, input);
+	if (outcome.count === 0) {
+		const within = [
+			input.namespace !== void 0 ? `namespace "${input.namespace}"` : void 0,
+			input.method !== void 0 ? `method ${input.method.toUpperCase()}` : void 0,
+			input.access !== void 0 ? `${input.access} routes` : void 0
+		].filter((part) => part !== void 0).join(", ");
 		return {
-			ok: false,
-			error: `No routes in namespace "${input.namespace}". This WordPress serves: ${known.join(", ")}.`
+			ok: true,
+			value: {
+				...outcome,
+				message: `No route matches that search${within === "" ? "" : ` within ${within}`}. This WordPress serves these namespaces: ${outcome.namespaces.join(", ")}.`
+			}
 		};
 	}
 	return {
 		ok: true,
-		value: {
-			count: routes.length,
-			routes: routes.map((route) => ({
-				name: route.name,
-				namespace: route.namespace,
-				method: route.method,
-				path: route.path,
-				...route.summary !== void 0 ? { summary: route.summary } : {},
-				...route.deprecated ? { deprecated: true } : {}
-			}))
-		}
+		value: outcome
 	};
 }
-/** The full argument schema for one route, which is what a caller needs before it can build a call. */
+/** The full contract for one route, which is what a caller needs before it can build a call. */
 function describeRoute(state, input) {
-	if (!state.document) return {
-		ok: false,
-		error: NO_DOCUMENT
-	};
+	if (!state.document) return failed(NO_DOCUMENT);
 	const route = routesOf(state.document).get(input.route);
-	if (!route) return {
-		ok: false,
-		error: unknownRoute(input.route)
-	};
+	if (!route) return failed(unknownRoute(input.route));
 	return {
 		ok: true,
 		value: {
@@ -58,34 +60,36 @@ function describeRoute(state, input) {
 			...route.description !== void 0 ? { description: route.description } : {},
 			...route.deprecated ? { deprecated: true } : {},
 			pathParameters: route.definition.pathParameters,
-			input: toJsonSchema(route.operation.input, state.document)
+			input: inputJsonSchema(route.operation.input, state.document),
+			responses: responseSchemas(route.operation.responses, state.document),
+			errors: route.operation.errors
 		}
 	};
 }
 /** Run one route against the connected WordPress and hand back what it answered. */
 async function callRoute(state, input) {
-	if (!state.document) return {
-		ok: false,
-		error: NO_DOCUMENT
-	};
-	if (!state.credentials) return {
-		ok: false,
-		error: "No WordPress connection is configured, so nothing can be called. Check the connection settings in `.env`."
-	};
+	if (!state.document) return failed(NO_DOCUMENT);
+	if (!state.credentials) return failed("No WordPress connection is configured, so nothing can be called. Check the connection settings in `.env`.");
 	const route = routesOf(state.document).get(input.route);
-	if (!route) return {
-		ok: false,
-		error: unknownRoute(input.route)
-	};
+	if (!route) return failed(unknownRoute(input.route));
 	const built = buildWordPressRequest(route.definition, input.input ?? {});
-	if (built.error) return {
-		ok: false,
-		error: built.error.message
-	};
+	if (built.error) return failed(built.error.message);
 	const response = await new WordPressTransport({ credentials: state.credentials }).request(built.request);
 	if (response.error) return {
 		ok: false,
-		error: `${route.method} ${route.path} failed (${response.status || "no response"}): ${response.error.code} — ${response.error.message}`
+		error: {
+			kind: "response",
+			message: `${route.method} ${route.path} failed (${response.status || "no response"}): ${response.error.code} — ${response.error.message}`,
+			route: route.name,
+			method: route.method,
+			path: route.path,
+			status: response.status,
+			error: {
+				code: response.error.code,
+				message: response.error.message,
+				data: response.error.data
+			}
+		}
 	};
 	return {
 		ok: true,
@@ -95,9 +99,18 @@ async function callRoute(state, input) {
 		}
 	};
 }
+/** The response half of the contract, converted so a caller can read a success or a failure body. */
+function responseSchemas(responses, document) {
+	return Object.fromEntries(Object.entries(responses).map(([status, response]) => [status, {
+		...response.description !== void 0 ? { description: response.description } : {},
+		...response.content_type !== void 0 ? { content_type: response.content_type } : {},
+		...response.headers ? { headers: toJsonSchema(response.headers, document) } : {},
+		...response.body ? { body: toJsonSchema(response.body, document) } : {}
+	}]));
+}
 function unknownRoute(name) {
-	return `No route named "${name}" in this WordPress contract. Call \`kizlo_list_routes\` for the routes it serves.`;
+	return `No route named "${name}" in this WordPress contract. Call \`kizlo_search_routes\` for the routes it serves.`;
 }
 
 //#endregion
-export { callRoute, describeRoute, listRoutes };
+export { callRoute, describeRoute, searchRoutes$1 as searchRoutes };

package/dist/comment/index.js

@@ -17,8 +17,8 @@ const COMMENT_PROCEDURES = {
 		output: Comment
 	}, async ({ context, errors, input }) => {
 		const response = await context.wordpress.comments.retrieve({
-			id: input.params.id,
-			password: input.query?.password
+			params: { id: input.params.id },
+			query: { password: input.query?.password }
 		});
 		if (response.error) switch (response.error.code) {
 			case "rest_comment_invalid_id":
@@ -63,7 +63,7 @@ const COMMENT_PROCEDURES = {
 			post: listed(input.query?.post),
 			search: input.query?.search
 		};
-		const response = await context.wordpress.comments.list(searchParams);
+		const response = await context.wordpress.comments.list({ query: searchParams });
 		if (response.error) switch (response.error.code) {
 			case "rest_cannot_read":
 			case "rest_cannot_read_post":
@@ -114,7 +114,7 @@ const COMMENT_PROCEDURES = {
 			author_url: input.body.authorUrl,
 			parent: input.body.parentId
 		};
-		const response = await context.wordpress.kizlo.comments.create(submission);
+		const response = await context.wordpress.kizlo.comments.create({ body: submission });
 		if (response.error) switch (response.error.code) {
 			case "require_name_email": throw errors.COMMENT_NAME_EMAIL_REQUIRED();
 			case "require_valid_email": throw errors.COMMENT_INVALID_EMAIL();

package/dist/email/service.js

@@ -5,7 +5,7 @@ var EmailService = class {
 		this.wordpress = wordpress;
 	}
 	async send(params) {
-		const { error } = await this.wordpress.email.send(params);
+		const { error } = await this.wordpress.kizlo.email.send({ body: params });
 		if (error) throw error;
 	}
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { WP_Error } from "./wordpress/error.js";
-import { ActiveWordPressClient, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry } from "./wordpress/types.js";
+import { ActiveWordPressClient, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_RequestParts, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry } from "./wordpress/types.js";
 import { WordPressTransport, WordPressTransportOptions, WordPressTransportResult } from "./wordpress/transport.js";
 import { buildWordPressRequest, createWordPressClient, wpEndpoint } from "./wordpress/endpoint.js";
 import { isWordPressResourceError } from "./wordpress/utils.js";
@@ -43,4 +43,4 @@ import { ShaAlgorithm, compare, hash, hmac } from "./shared/crypto.js";
 import { Identifier, parseIdentifier } from "./shared/identifier.js";
 import { createOrpcRouter } from "./shared/router.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
-export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };
+export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_RequestParts, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };

package/dist/menu/utils.js

@@ -3,7 +3,7 @@ import { listed, stringifiedMetaRecord } from "@kizlo/shared";
 //#region src/menu/utils.ts
 function deserializeListMenuInput(input) {
 	const orderby = input?.orderby === "relevance" && !input?.search || input?.orderby === "include" && input?.include === void 0 || input?.orderby === "include_slugs" && input?.slug === void 0 ? void 0 : input?.orderby;
-	return {
+	return { query: {
 		after: input?.after,
 		before: input?.before,
 		exclude: listed(input?.exclude),
@@ -21,7 +21,7 @@ function deserializeListMenuInput(input) {
 		tax_relation: input?.taxRelation,
 		search_columns: input?.searchColumns,
 		status: ["publish"]
-	};
+	} };
 }
 /**
 * The `href` a headless frontend links to. WP builds a non-custom item's `url` as an absolute same-site

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.21.0";
+var version = "0.22.0";
 
 //#endregion
 export { version };

package/dist/page/index.js

@@ -24,7 +24,7 @@ const PAGE_PROCEDURES = {
 		if (input.query?.previewToken) {
 			const result = await context.verifyPreviewToken(input.query.previewToken);
 			if (!result) throw errors.PAGE_NOT_FOUND();
-			const response$1 = await context.wordpress.postTypes.page.retrieve({ identifier: String(result.id) });
+			const response$1 = await context.wordpress.kizlo.postTypes.page.retrieve({ params: { identifier: String(result.id) } });
 			if (response$1.error) switch (response$1.error.code) {
 				case "invalid_post_type":
 				case "post_type_not_found":
@@ -44,7 +44,7 @@ const PAGE_PROCEDURES = {
 		}
 		const identifier = parseIdentifier(input.params.identifier);
 		if (!identifier) throw errors.PAGE_NOT_FOUND();
-		const response = await context.wordpress.postTypes.page.retrieve({ identifier: String(identifier.value) });
+		const response = await context.wordpress.kizlo.postTypes.page.retrieve({ params: { identifier: String(identifier.value) } });
 		if (response.error) switch (response.error.code) {
 			case "invalid_post_type":
 			case "post_type_not_found":
@@ -78,7 +78,7 @@ const PAGE_PROCEDURES = {
 	}, async ({ input, context, errors }) => {
 		const q = input.query;
 		const orderby = q?.orderby === "relevance" && !q?.search || q?.orderby === "include" && q?.include === void 0 ? void 0 : q?.orderby;
-		const response = await context.wordpress.postTypes.page.list({
+		const response = await context.wordpress.kizlo.postTypes.page.list({ query: {
 			status: ["publish"],
 			after: q?.after,
 			author: normalizeArrayableValue(q?.author),
@@ -99,7 +99,7 @@ const PAGE_PROCEDURES = {
 			search: q?.search,
 			search_columns: q?.searchColumns,
 			slug: normalizeArrayableValue(q?.slug)
-		});
+		} });
 		if (response.error) switch (response.error.code) {
 			case "rest_post_invalid_page_number": throw errors.PAGE_INVALID_PAGE();
 			case "rest_no_route": throw errors.PAGE_NOT_FOUND();

package/dist/page/schema.d.ts

@@ -5,7 +5,7 @@ import z from "zod/v4";
 
 //#region src/page/schema.d.ts
 
-type PageCustomFields = WP_CustomFields<"postTypes.page">;
+type PageCustomFields = WP_CustomFields<"kizlo.postTypes.page">;
 declare const PageCustomFieldsSchema: z.ZodType<PageCustomFields, PageCustomFields>;
 declare const Page: z.ZodObject<{
   id: z.ZodNumber;

package/dist/post/index.js

@@ -24,7 +24,7 @@ const POST_PROCEDURES = {
 		if (input.query?.previewToken) {
 			const result = await context.verifyPreviewToken(input.query.previewToken);
 			if (!result) throw errors.POST_NOT_FOUND();
-			const response$1 = await context.wordpress.postTypes.post.retrieve({ identifier: String(result.id) });
+			const response$1 = await context.wordpress.kizlo.postTypes.post.retrieve({ params: { identifier: String(result.id) } });
 			if (response$1.error) switch (response$1.error.code) {
 				case "invalid_post_type":
 				case "post_type_not_found":
@@ -44,7 +44,7 @@ const POST_PROCEDURES = {
 		}
 		const identifier = parseIdentifier(input.params.identifier);
 		if (!identifier) throw errors.POST_NOT_FOUND();
-		const response = await context.wordpress.postTypes.post.retrieve({ identifier: String(identifier.value) });
+		const response = await context.wordpress.kizlo.postTypes.post.retrieve({ params: { identifier: String(identifier.value) } });
 		if (response.error) switch (response.error.code) {
 			case "invalid_post_type":
 			case "post_type_not_found":
@@ -78,7 +78,7 @@ const POST_PROCEDURES = {
 	}, async ({ input, context, errors }) => {
 		const q = input.query;
 		const orderby = q?.orderby === "relevance" && !q?.search || q?.orderby === "include" && q?.include === void 0 ? void 0 : q?.orderby;
-		const response = await context.wordpress.postTypes.post.list({
+		const response = await context.wordpress.kizlo.postTypes.post.list({ query: {
 			status: ["publish"],
 			after: q?.after,
 			author: normalizeArrayableValue(q?.author),
@@ -102,7 +102,7 @@ const POST_PROCEDURES = {
 			tags: normalizeArrayableValue(q?.tags),
 			tags_exclude: normalizeArrayableValue(q?.tagsExclude),
 			tax_relation: q?.taxRelation
-		});
+		} });
 		if (response.error) switch (response.error.code) {
 			case "rest_post_invalid_page_number": throw errors.POST_INVALID_PAGE();
 			case "rest_no_route": throw errors.POST_NOT_FOUND();

package/dist/post/schema.d.ts

@@ -5,7 +5,7 @@ import z from "zod/v4";
 
 //#region src/post/schema.d.ts
 
-type PostCustomFields = WP_CustomFields<"postTypes.post">;
+type PostCustomFields = WP_CustomFields<"kizlo.postTypes.post">;
 declare const PostCustomFieldsSchema: z.ZodType<PostCustomFields, PostCustomFields>;
 declare const Post: z.ZodObject<{
   id: z.ZodNumber;
@@ -26,13 +26,13 @@ declare const Post: z.ZodObject<{
     private: "private";
   }>;
   format: z.ZodEnum<{
-    image: "image";
-    link: "link";
     status: "status";
     standard: "standard";
     aside: "aside";
     chat: "chat";
     gallery: "gallery";
+    link: "link";
+    image: "image";
     quote: "quote";
     video: "video";
     audio: "audio";
@@ -150,13 +150,13 @@ declare const PostList: z.ZodObject<{
       private: "private";
     }>;
     format: z.ZodEnum<{
-      image: "image";
-      link: "link";
       status: "status";
       standard: "standard";
       aside: "aside";
       chat: "chat";
       gallery: "gallery";
+      link: "link";
+      image: "image";
       quote: "quote";
       video: "video";
       audio: "audio";

package/dist/procedures.d.ts

@@ -44,7 +44,7 @@ declare const CORE_PROCEDURES: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "modified" | "relevance" | undefined;
+        orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         taxRelation?: "AND" | "OR" | undefined;
@@ -99,7 +99,7 @@ declare const CORE_PROCEDURES: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "modified" | "relevance" | "menu_order" | undefined;
+        orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "modified" | "relevance" | "include_slugs" | "menu_order" | undefined;
         searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
         slug?: string | string[] | undefined;
         parent?: string | number | (string | number)[] | undefined;
@@ -136,7 +136,7 @@ declare const CORE_PROCEDURES: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "id" | "name" | "slug" | "description" | "include" | "include_slugs" | "term_group" | "count" | undefined;
+        orderBy?: "id" | "count" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
         hideEmpty?: string | boolean | undefined;
         parent?: string | number | undefined;
         post?: string | number | undefined;
@@ -172,7 +172,7 @@ declare const CORE_PROCEDURES: {
         exclude?: string | number | (string | number)[] | undefined;
         include?: string | number | (string | number)[] | undefined;
         order?: "asc" | "desc" | undefined;
-        orderBy?: "id" | "name" | "slug" | "description" | "include" | "include_slugs" | "term_group" | "count" | undefined;
+        orderBy?: "id" | "count" | "slug" | "name" | "description" | "include" | "include_slugs" | "term_group" | undefined;
         hideEmpty?: string | boolean | undefined;
         post?: string | number | undefined;
         slug?: string | string[] | undefined;
@@ -241,7 +241,7 @@ declare const CORE_PROCEDURES: {
     sitemaps: {
       list: Procedure<"internal", {}, {
         key: string;
-        type: "author" | "post_type" | "taxonomy";
+        type: "post_type" | "taxonomy" | "author";
         pages: number;
         lastmod: string;
       }[], DefinedErrorMapLike>;
@@ -249,7 +249,7 @@ declare const CORE_PROCEDURES: {
         origin: string;
         sitemaps: {
           key: string;
-          type: "author" | "post_type" | "taxonomy";
+          type: "post_type" | "taxonomy" | "author";
           pages: number;
           lastmod: string;
         }[];
@@ -292,7 +292,7 @@ declare const CORE_PROCEDURES: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "relevance" | "menu_order" | undefined;
+          orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -371,7 +371,7 @@ declare const CORE_PROCEDURES: {
           include?: string | number | (string | number)[] | undefined;
           offset?: string | number | undefined;
           order?: "asc" | "desc" | undefined;
-          orderby?: "id" | "slug" | "parent" | "title" | "author" | "date" | "include" | "include_slugs" | "relevance" | "menu_order" | undefined;
+          orderby?: "id" | "date" | "slug" | "parent" | "title" | "author" | "include" | "relevance" | "include_slugs" | "menu_order" | undefined;
           searchColumns?: ("post_title" | "post_content" | "post_excerpt")[] | undefined;
           slug?: string | string[] | undefined;
           taxRelation?: "AND" | "OR" | undefined;
@@ -507,7 +507,7 @@ declare const CORE_PROCEDURES: {
         include?: string | number | (string | number)[] | undefined;
         offset?: string | number | undefined;
         order?: "asc" | "desc" | undefined;
-        orderby?: "id" | "parent" | "date" | "include" | "post" | undefined;
+        orderby?: "id" | "date" | "parent" | "include" | "post" | undefined;
         parent?: string | number | (string | number)[] | undefined;
         parentExclude?: string | number | (string | number)[] | undefined;
         post?: string | number | (string | number)[] | undefined;
@@ -635,8 +635,8 @@ declare const CORE_PROCEDURES: {
     get: Procedure<"internal", {}, _kizlo_shared11.Settings, DefinedErrorMapLike>;
     site: {
       update: Procedure<"internal", {
-        name?: string | null | undefined;
         url?: string | null | undefined;
+        name?: string | null | undefined;
         backend_url?: string | null | undefined;
         secret?: string | null | undefined;
         alternate_name?: string | null | undefined;