create-ailk 0.24.0 → 0.26.0

package/templates/apps/mcp/src/tools/get_offerings.ts

@@ -1,96 +0,0 @@
-/**
- * get_offerings — returns Services and/or Products as a unified offerings array.
- *
- * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
- * resolver seam (#5805, ADR 0011), MDX by default — and answers through
- * `listOfferings` (`@working-theory/content-adapters`), which lists pages of
- * type "Service" and/or "Product" and shapes them into a unified offerings
- * array. Optionally filtered by type.
- *
- * HTTP twin (#7177): `GET /v1/content/offerings` in `apps/api` takes the same
- * arguments and answers through the same `listOfferings` — the shared seam
- * the pair proves parity at. The tool still reads content locally, so it
- * needs no API to answer.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07). Lists are locale-scoped.
- *
- * The offering fields (#5838) — `provider`, `categories`, `price` and
- * `priceCurrency` — come off the page's own frontmatter; `listOfferings`
- * documents the mapping.
- *
- * Offerings (#8933, spec D8): when the site sells through its connected
- * Stripe catalog and `type` is not `service`, the tool answers the Service
- * pages followed by the workspace's Offerings shown set, in place of the
- * Product pages — read over HTTP by `lib/shown-offerings.ts` (D6: only on a
- * `claimed` host, at most `MCP_SHOWN_SET_BUDGET_MS`) and mapped by
- * `listOfferingsWithShownSet`, the function the twin route answers through
- * too, so each shown product also carries `prices` (every price with its
- * interval and full lookup key). Names, descriptions and prices are
- * seller-provided data returned as plain JSON values (T5). `type: "service"`,
- * an unclaimed host, a workspace with no current set, a failed read or a
- * mapping that throws answers the page content below, unchanged.
- *
- * Input:  { type?: 'service' | 'product', locale?: string }
- * Output: { offerings: Array<{ name, description, category?, image?, provider, categories, price, priceCurrency, prices? }> }
- * Session/scope: none — read-only public content.
- */
-
-import {
-  listOfferings,
-  listOfferingsWithShownSet,
-} from "@working-theory/content-adapters";
-import {
-  getOfferingsInputSchema,
-  getOfferingsOutputSchema,
-  type GetOfferingsInput,
-  type GetOfferingsOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-import {
-  mcpCurrentShownSet,
-  reportMappingFailure,
-} from "../lib/shown-offerings.js";
-
-export { getOfferingsInputSchema, getOfferingsOutputSchema };
-export type { GetOfferingsInput, GetOfferingsOutput };
-
-/**
- * get_offerings handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetOfferings(
-  input: GetOfferingsInput,
-  contentRoot?: string,
-): Promise<GetOfferingsOutput> {
-  getOfferingsInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  if (input.type !== "service") {
-    const shownSet = await mcpCurrentShownSet();
-    if (shownSet !== null) {
-      try {
-        return await listOfferingsWithShownSet(
-          adapter,
-          { type: input.type, locale },
-          shownSet,
-        );
-      } catch (err) {
-        reportMappingFailure(err);
-      }
-    }
-  }
-
-  return listOfferings(adapter, { type: input.type, locale });
-}

package/templates/apps/mcp/src/tools/get_pricing.ts

@@ -1,94 +0,0 @@
-/**
- * get_pricing — returns pricing tiers from Offer structured data.
- *
- * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
- * resolver seam (#5805, ADR 0011), MDX by default.
- * Resolves a page by slug (default: "pricing") and extracts Offer schema.
- * Returns null when the page is not found or has no offer data.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07).
- *
- * Fallback (#5838): when the page authors no `offers` in its `schema`, the
- * offering fields on its own frontmatter answer instead — a listing that
- * declares `price` + `priceCurrency` yields one tier named for the page. A
- * listing with neither an authored offer nor a price still returns `null`: no
- * price means no tier, never a fabricated zero. `getPricingTiers`
- * (`@working-theory/content-adapters`) documents the mapping.
- *
- * HTTP twin (#7178): `GET /v1/content/pricing` in `apps/api` takes the same
- * arguments and answers through the same `getPricingTiers` — the shared seam
- * the pair proves parity at. The tool still reads content locally, so it
- * needs no API to answer.
- *
- * Offerings (#8933, spec D8): when the site sells through its connected
- * Stripe catalog and `slug` is omitted or `pricing`, the tool answers the
- * workspace's Offerings shown set instead — read over HTTP by
- * `lib/shown-offerings.ts` (D6: only on a `claimed` host, at most
- * `MCP_SHOWN_SET_BUDGET_MS`) and mapped by `pricingTiersFromShownSet`, the
- * function the twin route answers through too, so each tier also carries
- * `interval` and the full `lookupKey`. Names, descriptions and prices are
- * seller-provided data returned as plain JSON values (T5). Any other slug, an
- * unclaimed host, a workspace with no current set, a failed read or a mapping
- * that throws answers the page content below, unchanged.
- *
- * Input:  { slug?: string, locale?: string }
- * Output: { tiers: Array<{ name, price, priceCurrency, description?, interval?, lookupKey? }> } | null
- * Session/scope: none — read-only public content.
- */
-
-import {
-  getPricingTiers,
-  pricingTiersFromShownSet,
-  shownSetAnswersPricing,
-} from "@working-theory/content-adapters";
-import {
-  getPricingInputSchema,
-  getPricingOutputSchema,
-  type GetPricingInput,
-  type GetPricingOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-import {
-  mcpCurrentShownSet,
-  reportMappingFailure,
-} from "../lib/shown-offerings.js";
-
-export { getPricingInputSchema, getPricingOutputSchema };
-export type { GetPricingInput, GetPricingOutput };
-
-/**
- * get_pricing handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetPricing(
-  input: GetPricingInput,
-  contentRoot?: string,
-): Promise<GetPricingOutput> {
-  getPricingInputSchema.parse(input);
-
-  if (shownSetAnswersPricing(input.slug)) {
-    const shownSet = await mcpCurrentShownSet();
-    if (shownSet !== null) {
-      try {
-        return pricingTiersFromShownSet(shownSet);
-      } catch (err) {
-        reportMappingFailure(err);
-      }
-    }
-  }
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  return getPricingTiers(adapter, { slug: input.slug, locale });
-}

package/templates/apps/mcp/src/tools/get_site_info.ts

@@ -1,86 +0,0 @@
-/**
- * get_site_info — returns structured site identity from the HomePage.
- *
- * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
- * resolver seam (#5805, ADR 0011), MDX by default.
- * Resolves the HomePage by slug (default: "home") and extracts the `schema`
- * frontmatter field. Returns null when the page is not found or has no schema.
- *
- * Phase 3 S3: optional `locale` parameter (BCP-47). Validated against the
- * project's allowlist; invalid or unknown values silently fall back to the
- * default locale (AC-i18n-07).
- *
- * Input:  { slug?: string, locale?: string }
- * Output: { name, description, contact?, brandColors?, socialHandles? } | null
- * Session/scope: none — read-only public content.
- */
-
-import {
-  getSiteInfoInputSchema,
-  getSiteInfoOutputSchema,
-  type GetSiteInfoInput,
-  type GetSiteInfoOutput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-
-export { getSiteInfoInputSchema, getSiteInfoOutputSchema };
-export type { GetSiteInfoInput, GetSiteInfoOutput };
-
-const DEFAULT_SLUG = "home";
-
-/**
- * get_site_info handler.
- *
- * Accepts an optional `contentRoot` override for testing. When omitted,
- * resolves it through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkGetSiteInfo(
-  input: GetSiteInfoInput,
-  contentRoot?: string,
-): Promise<GetSiteInfoOutput> {
-  getSiteInfoInputSchema.parse(input);
-
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  const slug = input.slug ?? DEFAULT_SLUG;
-  const data = await adapter.extractStructuredData("HomePage", slug, locale);
-  if (!data) return null;
-
-  const schema = data as Record<string, unknown>;
-
-  const contactRaw = schema["contactPoint"] as
-    | Record<string, unknown>
-    | undefined;
-  const contact =
-    contactRaw !== undefined
-      ? {
-          email: contactRaw["email"] as string | undefined,
-          phone: contactRaw["telephone"] as string | undefined,
-        }
-      : undefined;
-
-  const colorsRaw = schema["brandColors"];
-  const brandColors = Array.isArray(colorsRaw)
-    ? (colorsRaw as string[])
-    : undefined;
-
-  const socialsRaw = schema["sameAs"];
-  const socialHandles = Array.isArray(socialsRaw)
-    ? (socialsRaw as string[])
-    : undefined;
-
-  return getSiteInfoOutputSchema.parse({
-    name: (schema["name"] as string) ?? "",
-    description: (schema["description"] as string) ?? "",
-    contact,
-    brandColors,
-    socialHandles,
-  });
-}

package/templates/apps/mcp/src/tools/index.ts

@@ -1,138 +0,0 @@
-/**
- * MCP tool registry — re-exports every tool module.
- *
- * Add new tool modules here as they land in Phase 3+.
- */
-
-export {
-  purchaseInputSchema,
-  purchaseOutputSchema,
-  ailkPurchase,
-  type PurchaseInput,
-  type PurchaseOutput,
-} from "./purchase.js";
-
-export {
-  contentListParamsSchema,
-  contentListQuerySchema,
-  contentListResultSchema,
-  ailkListPages,
-  type ListPagesInput,
-  type ContentListResult,
-} from "./list_pages.js";
-
-export {
-  contentPageParamsSchema,
-  contentPageQuerySchema,
-  contentPageResultSchema,
-  ailkReadContent,
-  type ReadContentInput,
-  type ContentPageResult,
-} from "./read_content.js";
-
-export {
-  contentSearchQuerySchema,
-  contentSearchResultSchema,
-  ailkSearchContent,
-  type SearchContentInput,
-  type ContentSearchResult,
-} from "./search_content.js";
-
-export {
-  getSiteInfoInputSchema,
-  getSiteInfoOutputSchema,
-  ailkGetSiteInfo,
-  type GetSiteInfoInput,
-  type GetSiteInfoOutput,
-} from "./get_site_info.js";
-
-export {
-  getBusinessHoursInputSchema,
-  getBusinessHoursOutputSchema,
-  ailkGetBusinessHours,
-  type GetBusinessHoursInput,
-  type GetBusinessHoursOutput,
-} from "./get_business_hours.js";
-
-export {
-  getLocationsInputSchema,
-  getLocationsOutputSchema,
-  ailkGetLocations,
-  type GetLocationsInput,
-  type GetLocationsOutput,
-} from "./get_locations.js";
-
-export {
-  getOfferingsInputSchema,
-  getOfferingsOutputSchema,
-  ailkGetOfferings,
-  type GetOfferingsInput,
-  type GetOfferingsOutput,
-} from "./get_offerings.js";
-
-export {
-  getPricingInputSchema,
-  getPricingOutputSchema,
-  ailkGetPricing,
-  type GetPricingInput,
-  type GetPricingOutput,
-} from "./get_pricing.js";
-
-export {
-  getFaqInputSchema,
-  getFaqOutputSchema,
-  ailkGetFaq,
-  type GetFaqInput,
-  type GetFaqOutput,
-} from "./get_faq.js";
-
-export {
-  auditInputSchema,
-  auditOutputSchema,
-  ailkAudit,
-  type AuditInput,
-  type AuditOutput,
-} from "./audit.js";
-
-// #7171, #7172, #7173 — the three lead writes take their routes' body
-// exports and share one output schema (the route's 201 body or the tool's
-// error), re-exported once from capture_lead.
-export {
-  leadSubmitBodySchema,
-  leadWriteOutputSchema,
-  ailkCaptureLead,
-  type LeadSubmitBody,
-  type LeadWriteOutput,
-} from "./capture_lead.js";
-
-export {
-  leadSubscribeBodySchema,
-  ailkSubscribeNewsletter,
-  type LeadSubscribeBody,
-} from "./subscribe_newsletter.js";
-
-export {
-  leadCallbackBodySchema,
-  ailkRequestCallback,
-  type LeadCallbackBody,
-} from "./request_callback.js";
-
-export {
-  scaffoldInputSchema,
-  scaffoldOutputSchema,
-  ailkCreateProject,
-  type ScaffoldInput,
-  type ScaffoldOutput,
-} from "./create_project.js";
-
-// The scheduling tools (list_availability, get_event_meta, create_booking)
-// and the signal-collectors flow tools (get_flow, submit_flow_step) are
-// deliberately NOT re-exported here. (The content-write tools that used to sit
-// in this list — create_page, update_page, delete_page — no longer exist at
-// all: #5853 retired them with their HTTP twins.)
-// Both remaining groups are module-conditional slice files
-// (#5182): a re-export from this barrel is a static path into a file the OSS
-// strip removes, which reds the public tree's type-check. They are reached
-// only through `createMcpServer`'s per-module loader in ../server.ts.
-// The rule this barrel now follows: it re-exports exactly the tools no module
-// gate can remove.

package/templates/apps/mcp/src/tools/list_pages.ts

@@ -1,68 +0,0 @@
-/**
- * list_pages — returns one page of the published content pages of a type.
- *
- * Pure read: resolves its adapter through `getMcpContentAdapter()` — the one
- * resolver seam (#5805, ADR 0011), MDX by default — and answers through
- * `listPagesItemList` (`@working-theory/content-adapters`).
- * No auth, no side effects, no network. The adapter reads from the filesystem.
- *
- * HTTP twin (#7168): `GET /v1/content/:type` in `apps/api` parses the same
- * `contentListParamsSchema` + `contentListQuerySchema` and answers through
- * the same builder — the tool adopted the API, arguments and results: `type`
- * is required, and `page` (default 1) / `pageSize` (default 20, at most 100)
- * pick the window.
- *
- * Phase 3 S3: optional `locale` parameter. Validated against `readLocales()`
- * allowlist; invalid or unknown values silently fall back to the project's
- * default locale (AC-i18n-07). Lists are locale-scoped — pages must exist in
- * the requested locale's directory to be enumerated.
- *
- * Input:  { type: SchemaOrgType, page?: number, pageSize?: number, locale?: string }
- * Output: { "@context", "@type": "ItemList", type, items: ContentPage[],
- *           pagination: { page, pageSize, totalItems, totalPages } }
- * Session/scope: none — read-only public content.
- */
-
-import { listPagesItemList } from "@working-theory/content-adapters";
-import {
-  contentListParamsSchema,
-  contentListQuerySchema,
-  contentListResultSchema,
-  type ContentListResult,
-  type ListPagesInput,
-} from "@working-theory/validation";
-
-import {
-  getMcpContentAdapter,
-  mcpContentRoot,
-} from "../lib/content-adapter.js";
-import { resolveLocale } from "../lib/resolve-locale.js";
-
-export {
-  contentListParamsSchema,
-  contentListQuerySchema,
-  contentListResultSchema,
-};
-export type { ListPagesInput, ContentListResult };
-
-/**
- * list_pages handler.
- *
- * Accepts an optional `contentRoot` override for testing (avoids coupling
- * unit tests to the deployed filesystem layout). When omitted, resolves it
- * through `mcpContentRoot()` (#8070 D3).
- */
-export async function ailkListPages(
-  input: ListPagesInput,
-  contentRoot?: string,
-): Promise<ContentListResult> {
-  const { type } = contentListParamsSchema.parse(input);
-  const { page, pageSize } = contentListQuerySchema.parse(input);
-
-  // Default: the one content-root resolver (#8070 D3).
-  const root = contentRoot ?? mcpContentRoot();
-  const locale = resolveLocale(input.locale);
-  const adapter = getMcpContentAdapter({ contentRoot: root, locale });
-
-  return listPagesItemList(adapter, { type, page, pageSize, locale });
-}

package/templates/apps/mcp/src/tools/person_notes.ts

@@ -1,25 +0,0 @@
-// oss: false
-/**
- * The signed-in workspace surface's People notes tools (#8514 D8) — the twins
- * of `apps/api/src/routes/workspaces/people.ts`'s notes pair:
- *
- *   get_person_notes  GET /v1/workspaces/:workspaceId/people/:personId/notes
- *   set_person_notes  PUT /v1/workspaces/:workspaceId/people/:personId/notes
- *
- * Each takes the route's params and body (the SDK has already parsed them
- * against the catalog's input shape, which is the route's own schemas),
- * forwards the caller's agent key through `@working-theory/api-client`, and
- * returns the route's answer untouched. apps/api checks the key, the grant and
- * the workspace; this file only carries the key, and never logs or returns it.
- */
-
-import { people, type PersonRef } from "@working-theory/api-client";
-import type { PersonNotesPutInput } from "@working-theory/validation";
-
-export function ailkGetPersonNotes(key: string, input: PersonRef) {
-  return people.notes(key, input);
-}
-
-export function ailkSetPersonNotes(key: string, input: PersonRef & PersonNotesPutInput) {
-  return people.setNotes(key, input);
-}

package/templates/apps/mcp/src/tools/proposals.ts

@@ -1,27 +0,0 @@
-// oss: false
-/**
- * The signed-in workspace surface's proposals tools (#8516 D7) — the twins of
- * `apps/api/src/routes/workspaces/pieces.ts`'s proposals pair:
- *
- *   list_proposals   GET  /v1/workspaces/:workspaceId/people/:personId/proposals
- *   create_proposal  POST /v1/workspaces/:workspaceId/people/:personId/proposals
- *
- * Each takes the route's params and body (the SDK has already parsed them
- * against the catalog's input shape, which is the route's own schemas),
- * forwards the caller's agent key through `@working-theory/api-client`, and
- * returns the route's answer untouched. apps/api checks the key, the grant,
- * the workspace and the money gate (an agent's price is `403
- * proposal_needs_person`); this file only carries the key, and never logs or
- * returns it.
- */
-
-import { people, type PersonRef } from "@working-theory/api-client";
-import type { ProposalCreateBody } from "@working-theory/validation";
-
-export function ailkListProposals(key: string, input: PersonRef) {
-  return people.proposals(key, input);
-}
-
-export function ailkCreateProposal(key: string, input: PersonRef & ProposalCreateBody) {
-  return people.createProposal(key, input);
-}