@agentproto/canvakit 0.1.0-alpha.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,23 @@
+# @agentproto/canvakit
+
+AIP-5 `TEMPLATE.md` reference implementation. A markdown + frontmatter format for templates that declare named data sources, resolve them in parallel, and re-render when data changes.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-5>
+
+## Usage
+
+```ts
+import { defineCanvakit } from "@agentproto/canvakit"
+
+const x = defineCanvakit({
+  id: "my-canvakit",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-D44K7M6V.mjs

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/canvakit v0.1.0-alpha
+ * AIP-5 TEMPLATE.md `defineCanvakit` reference implementation.
+ */
+
+var canvakitFrontmatterSchema = z.object({ "schema": z.literal("canvakit/v1").describe("Spec version pin. Hosts that find an unknown schema MUST refuse rather than guess.").optional(), "template": z.literal(true).describe("Required marker. Tooling that loads files by glob uses this to catch 'renamed but not a template' mistakes."), "name": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).min(2).max(64).describe("Slug-safe machine name. Lowercase, digits, dashes."), "version": z.string().regex(new RegExp("^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$")).describe("Semver. Bump on breaking change to the rendered shape or variables contract."), "description": z.string().max(2e3).describe("One-sentence purpose for the gallery card.").optional(), "author": z.string().describe("Optional locally; required for gallery publish \u2014 (author, name, version) is the canonical key.").optional(), "renderer": z.enum(["mustache", "handlebars", "mdx"]).describe("Template engine. v1 default 'mustache' is universally supported; others are spec-legal but optional.").default("mustache"), "design": z.string().describe("Designkit fallback hint. Used only when no workspace design is active. Schemes: dk:<preset>, ws:<path>, kit:<slug>, or a bare *.md path.").optional(), "forceDesign": z.string().describe("Designkit override. Bypasses workspace selection. Same scheme grammar as 'design'.").optional(), "refreshEvery": z.union([z.enum(["manual", "on-tool-change"]), z.string().regex(new RegExp("^\\d+(ms|s|m|h)$")).describe("Duration string \u2014 e.g. 60s, 5m, 1h.")]).describe("Declarative cadence hint. Honored opportunistically; runtimes that can't honor SHOULD treat as 'manual'.").default("manual"), "variables": z.record(z.string(), z.any()).describe("Caller inputs with author defaults. Substituted into sources params before resolution.").default({}), "sources": z.record(z.string(), z.any()).describe("Named data sources resolved in parallel and merged into the render context.").default({}), "imports": z.record(z.string(), z.any()).describe("Nested canvases. Each renders in isolation; output exposed under {{{imports.<name>}}}.").default({}), "tags": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*$"))).default([]), "metadata": z.record(z.string(), z.any()).describe("Host-specific extension surface. Other hosts MUST tolerate unknown metadata.<host>.* keys.").default({}) }).describe("Validates the YAML frontmatter portion of an AIP-5 *.canvakit.* template.");
+var defineCanvakit = createDoctype({
+  aip: 5,
+  name: "canvakit",
+  readIdentity: (def) => def.name,
+  readDescription: false,
+  validate(def) {
+    const result = canvakitFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineCanvakit (AIP-5): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { canvakitFrontmatterSchema, defineCanvakit };
+//# sourceMappingURL=chunk-D44K7M6V.mjs.map
+//# sourceMappingURL=chunk-D44K7M6V.mjs.map

package/dist/chunk-D44K7M6V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-canvakit.ts"],"names":[],"mappings":"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","file":"chunk-D44K7M6V.mjs","sourcesContent":["/**\n * AIP-5 TEMPLATE.md frontmatter zod schema.\n *\n * Generated from `resources/aip-5/draft/TEMPLATE.schema.json` via\n * json-schema-to-zod. Imported by both `define-canvakit.ts` (TS path\n * validation) and `manifest/index.ts` (.md path validation) so every\n * field-level constraint runs in both authoring paths from a single\n * source of truth — re-run scaffold-aip to refresh after spec changes.\n *\n * Cross-field rules (if/then/allOf in JSON Schema) don't translate\n * cleanly and live in `define-canvakit.ts`'s `validate(def)` instead.\n */\n\nimport { z } from \"zod\"\n\nexport const canvakitFrontmatterSchema = z.object({ \"schema\": z.literal(\"canvakit/v1\").describe(\"Spec version pin. Hosts that find an unknown schema MUST refuse rather than guess.\").optional(), \"template\": z.literal(true).describe(\"Required marker. Tooling that loads files by glob uses this to catch 'renamed but not a template' mistakes.\"), \"name\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).min(2).max(64).describe(\"Slug-safe machine name. Lowercase, digits, dashes.\"), \"version\": z.string().regex(new RegExp(\"^\\\\d+\\\\.\\\\d+\\\\.\\\\d+(?:[-+][a-zA-Z0-9.-]+)?$\")).describe(\"Semver. Bump on breaking change to the rendered shape or variables contract.\"), \"description\": z.string().max(2000).describe(\"One-sentence purpose for the gallery card.\").optional(), \"author\": z.string().describe(\"Optional locally; required for gallery publish — (author, name, version) is the canonical key.\").optional(), \"renderer\": z.enum([\"mustache\",\"handlebars\",\"mdx\"]).describe(\"Template engine. v1 default 'mustache' is universally supported; others are spec-legal but optional.\").default(\"mustache\"), \"design\": z.string().describe(\"Designkit fallback hint. Used only when no workspace design is active. Schemes: dk:<preset>, ws:<path>, kit:<slug>, or a bare *.md path.\").optional(), \"forceDesign\": z.string().describe(\"Designkit override. Bypasses workspace selection. Same scheme grammar as 'design'.\").optional(), \"refreshEvery\": z.union([z.enum([\"manual\",\"on-tool-change\"]), z.string().regex(new RegExp(\"^\\\\d+(ms|s|m|h)$\")).describe(\"Duration string — e.g. 60s, 5m, 1h.\")]).describe(\"Declarative cadence hint. Honored opportunistically; runtimes that can't honor SHOULD treat as 'manual'.\").default(\"manual\"), \"variables\": z.record(z.string(), z.any()).describe(\"Caller inputs with author defaults. Substituted into sources params before resolution.\").default({} as never), \"sources\": z.record(z.string(), z.any()).describe(\"Named data sources resolved in parallel and merged into the render context.\").default({} as never), \"imports\": z.record(z.string(), z.any()).describe(\"Nested canvases. Each renders in isolation; output exposed under {{{imports.<name>}}}.\").default({} as never), \"tags\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\"))).default([] as never), \"metadata\": z.record(z.string(), z.any()).describe(\"Host-specific extension surface. Other hosts MUST tolerate unknown metadata.<host>.* keys.\").default({} as never) }).describe(\"Validates the YAML frontmatter portion of an AIP-5 *.canvakit.* template.\")\n\nexport type CanvakitFrontmatter = z.infer<typeof canvakitFrontmatterSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { canvakitFrontmatterSchema } from \"./schema.js\"\nimport type { CanvakitDefinition, CanvakitHandle } from \"./types.js\"\n\n/**\n * AIP-5 reference implementation of `defineCanvakit`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineCanvakit (AIP-5): …\"\n * error prefix) run uniformly with every other AIP defineX.\n *\n * Field-level validation runs the schema-derived zod from\n * `./schema.ts` against the input. Same source of truth as the .md\n * path uses (`parseCanvakitManifest`), so a malformed TS-authored\n * definition fails with the same diagnostic as a malformed manifest.\n * Cross-field rules go in `validate(def)` after the zod check.\n *\n * Identity / description extractors detected from the JSON Schema:\n *   readIdentity: def.name\n *   readDescription: skipped (no string-y required field detected).\n */\nexport const defineCanvakit = createDoctype<CanvakitDefinition, CanvakitHandle>({\n  aip: 5,\n  name: \"canvakit\",\n  readIdentity: (def) => def.name,\n  readDescription: false,\n  validate(def) {\n    const result = canvakitFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineCanvakit (AIP-5): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n    // TODO: spec-5-specific cross-field rules (if/then/allOf in\n    // the JSON Schema) — those don't translate to zod cleanly and\n    // belong here. See @agentproto/operator's autonomy=gated rule.\n  },\n  build(def) {\n    // Default build: spread the validated definition into a fresh object.\n    // Hand-tune for nested freezing (Object.freeze on arrays/objects) and\n    // for fields that need defaults applied — see @agentproto/operator\n    // for a reference shape.\n    return { ...def } as CanvakitHandle\n  },\n})\n"]}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import { C as CanvakitDefinition } from './types-DZeH88ZK.js';
+export { a as CanvakitHandle } from './types-DZeH88ZK.js';
+
+/**
+ * AIP-5 reference implementation of `defineCanvakit`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineCanvakit (AIP-5): …"
+ * error prefix) run uniformly with every other AIP defineX.
+ *
+ * Field-level validation runs the schema-derived zod from
+ * `./schema.ts` against the input. Same source of truth as the .md
+ * path uses (`parseCanvakitManifest`), so a malformed TS-authored
+ * definition fails with the same diagnostic as a malformed manifest.
+ * Cross-field rules go in `validate(def)` after the zod check.
+ *
+ * Identity / description extractors detected from the JSON Schema:
+ *   readIdentity: def.name
+ *   readDescription: skipped (no string-y required field detected).
+ */
+declare const defineCanvakit: (def: CanvakitDefinition) => Readonly<CanvakitDefinition>;
+
+/**
+ * @agentproto/canvakit — AIP-5 TEMPLATE.md `defineCanvakit` reference impl.
+ *
+ * A markdown + frontmatter format for templates that declare named data sources, resolve them in parallel, and re-render when data changes.
+ *
+ * Spec: https://agentproto.sh/docs/aip-5
+ *
+ * Authoring paths:
+ *   - TS:  `defineCanvakit({...})` → `CanvakitHandle`
+ *   - MD:  `parseCanvakitManifest(src) → canvakitFromManifest({...})` → `CanvakitHandle`
+ *
+ * The RENDER engine lives in `@canvakit/core` (`render`) — the reference
+ * implementation of this spec. This package is the spec/definition layer only.
+ */
+declare const SPEC_NAME: "agentcanvakit/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { CanvakitDefinition, SPEC_NAME, SPEC_VERSION, defineCanvakit };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { defineCanvakit } from './chunk-D44K7M6V.mjs';
+
+/**
+ * @agentproto/canvakit v0.1.0-alpha
+ * AIP-5 TEMPLATE.md `defineCanvakit` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentcanvakit/v1";
+var SPEC_VERSION = "1.0.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAeO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/canvakit — AIP-5 TEMPLATE.md `defineCanvakit` reference impl.\n *\n * A markdown + frontmatter format for templates that declare named data sources, resolve them in parallel, and re-render when data changes.\n *\n * Spec: https://agentproto.sh/docs/aip-5\n *\n * Authoring paths:\n *   - TS:  `defineCanvakit({...})` → `CanvakitHandle`\n *   - MD:  `parseCanvakitManifest(src) → canvakitFromManifest({...})` → `CanvakitHandle`\n *\n * The RENDER engine lives in `@canvakit/core` (`render`) — the reference\n * implementation of this spec. This package is the spec/definition layer only.\n */\n\nexport const SPEC_NAME = \"agentcanvakit/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport { defineCanvakit } from \"./define-canvakit.js\"\nexport type { CanvakitDefinition, CanvakitHandle } from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { a as CanvakitHandle } from '../types-DZeH88ZK.js';
+
+/**
+ * AIP-5 TEMPLATE.md frontmatter zod schema.
+ *
+ * Generated from `resources/aip-5/draft/TEMPLATE.schema.json` via
+ * json-schema-to-zod. Imported by both `define-canvakit.ts` (TS path
+ * validation) and `manifest/index.ts` (.md path validation) so every
+ * field-level constraint runs in both authoring paths from a single
+ * source of truth — re-run scaffold-aip to refresh after spec changes.
+ *
+ * Cross-field rules (if/then/allOf in JSON Schema) don't translate
+ * cleanly and live in `define-canvakit.ts`'s `validate(def)` instead.
+ */
+
+declare const canvakitFrontmatterSchema: z.ZodObject<{
+    schema: z.ZodOptional<z.ZodLiteral<"canvakit/v1">>;
+    template: z.ZodLiteral<true>;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    renderer: z.ZodDefault<z.ZodEnum<{
+        mustache: "mustache";
+        handlebars: "handlebars";
+        mdx: "mdx";
+    }>>;
+    design: z.ZodOptional<z.ZodString>;
+    forceDesign: z.ZodOptional<z.ZodString>;
+    refreshEvery: z.ZodDefault<z.ZodUnion<readonly [z.ZodEnum<{
+        manual: "manual";
+        "on-tool-change": "on-tool-change";
+    }>, z.ZodString]>>;
+    variables: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    sources: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    imports: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+type CanvakitFrontmatter = z.infer<typeof canvakitFrontmatterSchema>;
+
+/**
+ * AIP-5 TEMPLATE.md sidecar parser + manifest-to-handle constructor.
+ *
+ * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:
+ * the .md provides metadata; the TS module supplies any spec-specific
+ * runtime bits (schemas, execute bodies, …) that can't live in
+ * frontmatter. Both inputs end up in `defineCanvakit` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-5/draft/TEMPLATE.schema.json` via json-schema-to-zod.
+ * Re-run scaffold-aip to refresh after spec changes (or hand-tune
+ * any constraint the converter doesn't capture cleanly).
+ */
+
+interface CanvakitManifest {
+    frontmatter: CanvakitFrontmatter;
+    body: string;
+}
+declare function parseCanvakitManifest(source: string): CanvakitManifest;
+declare function canvakitFromManifest(manifest: CanvakitManifest): CanvakitHandle;
+
+export { type CanvakitFrontmatter, type CanvakitManifest, canvakitFromManifest, canvakitFrontmatterSchema, parseCanvakitManifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { canvakitFrontmatterSchema, defineCanvakit } from '../chunk-D44K7M6V.mjs';
+export { canvakitFrontmatterSchema } from '../chunk-D44K7M6V.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/canvakit v0.1.0-alpha
+ * AIP-5 TEMPLATE.md `defineCanvakit` reference implementation.
+ */
+function parseCanvakitManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseCanvakitManifest: missing or empty frontmatter");
+  }
+  const result = canvakitFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseCanvakitManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function canvakitFromManifest(manifest) {
+  return defineCanvakit(manifest.frontmatter);
+}
+
+export { canvakitFromManifest, parseCanvakitManifest };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/manifest/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/manifest/index.ts"],"names":[],"mappings":";;;;;;;;AA8BO,SAAS,sBAAsB,MAAA,EAAkC;AACtE,EAAA,MAAM,MAAA,GAAS,OAAO,MAAM,CAAA;AAC5B,EAAA,IAAI,OAAO,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,CAAE,WAAW,CAAA,EAAG;AACzC,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,MAAM,MAAA,GAAS,yBAAA,CAA0B,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAC9D,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,kDAAA,EAAgD,OAAO,KAAA,CAAM,MAAA,CAC1D,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAC,KAAK,CAAA,CAAE,OAAO,EAAE,CAAA,CAC9C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACf;AAAA,EACF;AACA,EAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,IAAA,EAAM,IAAA,EAAM,OAAO,OAAA,EAAQ;AAC1D;AAEO,SAAS,qBAAqB,QAAA,EAA4C;AAK/E,EAAA,OAAO,cAAA,CAAe,SAAS,WAA4C,CAAA;AAC7E","file":"index.mjs","sourcesContent":["/**\n * AIP-5 TEMPLATE.md sidecar parser + manifest-to-handle constructor.\n *\n * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:\n * the .md provides metadata; the TS module supplies any spec-specific\n * runtime bits (schemas, execute bodies, …) that can't live in\n * frontmatter. Both inputs end up in `defineCanvakit` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-5/draft/TEMPLATE.schema.json` via json-schema-to-zod.\n * Re-run scaffold-aip to refresh after spec changes (or hand-tune\n * any constraint the converter doesn't capture cleanly).\n */\n\nimport matter from \"gray-matter\"\nimport { canvakitFrontmatterSchema, type CanvakitFrontmatter } from \"../schema.js\"\nimport { defineCanvakit } from \"../define-canvakit.js\"\nimport type { CanvakitDefinition, CanvakitHandle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/canvakit/manifest\" or directly from \"@@agentproto/canvakit/schema\".\nexport { canvakitFrontmatterSchema, type CanvakitFrontmatter }\n\nexport interface CanvakitManifest {\n  frontmatter: CanvakitFrontmatter\n  body: string\n}\n\nexport function parseCanvakitManifest(source: string): CanvakitManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseCanvakitManifest: missing or empty frontmatter\")\n  }\n  const result = canvakitFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseCanvakitManifest: invalid frontmatter — ${result.error.issues\n        .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n        .join(\"; \")}`,\n    )\n  }\n  return { frontmatter: result.data, body: parsed.content }\n}\n\nexport function canvakitFromManifest(manifest: CanvakitManifest): CanvakitHandle {\n  // The zod-validated frontmatter is structurally compatible with\n  // CanvakitDefinition; the cast pins the typing once the manifest\n  // schema and the TS interface diverge (e.g. handle has frozen fields\n  // a literal config doesn't carry yet).\n  return defineCanvakit(manifest.frontmatter as unknown as CanvakitDefinition)\n}\n"]}

package/dist/types-DZeH88ZK.d.ts

@@ -0,0 +1,168 @@
+/**
+ * AIP-5 CanvakitDefinition + CanvakitHandle.
+ *
+ * `CanvakitDefinition` was generated from
+ * `resources/aip-5/draft/TEMPLATE.schema.json` via json-schema-to-typescript.
+ * `CanvakitHandle` is the readonly view of the same shape; tighten it
+ * by hand for fields that get defaults applied in build().
+ */
+/**
+ * Discriminated by 'kind'. One of: tool, static, file, query.
+ */
+type Source = SourceTool | SourceStatic | SourceFile | SourceQuery;
+/**
+ * Validates the YAML frontmatter portion of an AIP-5 *.canvakit.* template.
+ */
+interface CanvakitDefinition {
+    /**
+     * Spec version pin. Hosts that find an unknown schema MUST refuse rather than guess.
+     */
+    schema?: "canvakit/v1";
+    /**
+     * Required marker. Tooling that loads files by glob uses this to catch 'renamed but not a template' mistakes.
+     */
+    template: true;
+    /**
+     * Slug-safe machine name. Lowercase, digits, dashes.
+     */
+    name: string;
+    /**
+     * Semver. Bump on breaking change to the rendered shape or variables contract.
+     */
+    version: string;
+    /**
+     * One-sentence purpose for the gallery card.
+     */
+    description?: string;
+    /**
+     * Optional locally; required for gallery publish — (author, name, version) is the canonical key.
+     */
+    author?: string;
+    /**
+     * Template engine. v1 default 'mustache' is universally supported; others are spec-legal but optional.
+     */
+    renderer?: "mustache" | "handlebars" | "mdx";
+    /**
+     * Designkit fallback hint. Used only when no workspace design is active. Schemes: dk:<preset>, ws:<path>, kit:<slug>, or a bare *.md path.
+     */
+    design?: string;
+    /**
+     * Designkit override. Bypasses workspace selection. Same scheme grammar as 'design'.
+     */
+    forceDesign?: string;
+    /**
+     * Declarative cadence hint. Honored opportunistically; runtimes that can't honor SHOULD treat as 'manual'.
+     */
+    refreshEvery?: ("manual" | "on-tool-change") | string;
+    /**
+     * Caller inputs with author defaults. Substituted into sources params before resolution.
+     */
+    variables?: {
+        [k: string]: Variable;
+    };
+    /**
+     * Named data sources resolved in parallel and merged into the render context.
+     */
+    sources?: {
+        [k: string]: Source;
+    };
+    /**
+     * Nested canvases. Each renders in isolation; output exposed under {{{imports.<name>}}}.
+     */
+    imports?: {
+        [k: string]: Import;
+    };
+    tags?: string[];
+    /**
+     * Host-specific extension surface. Other hosts MUST tolerate unknown metadata.<host>.* keys.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+}
+interface Variable {
+    type?: "string" | "number" | "boolean" | "object" | "array";
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+}
+interface SourceTool {
+    kind: "tool";
+    /**
+     * Tool identifier. Flat ('searchFlights'), namespaced ('stripe.mrr'), or MCP-qualified ('mcp://server/tool'). Resolution: exact > longest wildcard > MCP.
+     */
+    ref: string;
+    /**
+     * JSON params passed verbatim to the resolver. String values may interpolate {{variables.*}}.
+     */
+    params?: {
+        [k: string]: unknown;
+    };
+    /**
+     * Legacy alias for 'params'. Hosts SHOULD accept and warn.
+     */
+    args?: {
+        [k: string]: unknown;
+    };
+}
+interface SourceStatic {
+    kind: "static";
+    /**
+     * Literal pass-through. Never fetched, never parsed.
+     */
+    value: {
+        [k: string]: unknown;
+    };
+}
+interface SourceFile {
+    kind: "file";
+    /**
+     * Filesystem path relative to the render filesystem. Parsed by extension per the format contract.
+     */
+    path: string;
+    /**
+     * Resolve `path` against a named workspace instead of the render filesystem. The host's workspace resolver supplies the filesystem (and enforces access); unconfigured cross-workspace refs surface as status:error.
+     */
+    workspace?: string;
+}
+interface SourceQuery {
+    kind: "query";
+    /**
+     * Glob or array of globs. Bare directory paths are rewritten to <path>/** /*.md.
+     */
+    include: string | [string, ...string[]];
+    /**
+     * Field predicates against parsed shape. Supports equality and operators _in, _contains, _before, _after.
+     */
+    where?: {
+        [k: string]: unknown;
+    };
+    /**
+     * field (asc) or -field (desc) on a parsed key.
+     */
+    sort?: string;
+    limit?: number;
+    /**
+     * Project to a subset of parsed keys.
+     */
+    fields?: string[];
+    /**
+     * Resolve the glob against a named workspace instead of the render filesystem. The host's workspace resolver supplies the filesystem (and enforces access); unconfigured cross-workspace refs surface as status:error.
+     */
+    workspace?: string;
+}
+interface Import {
+    /**
+     * Path to a sibling *.canvakit.* file.
+     */
+    template: string;
+    /**
+     * Values passed to the imported canvas. Imports do NOT inherit parent variables; pass explicitly.
+     */
+    variables?: {
+        [k: string]: unknown;
+    };
+}
+type CanvakitHandle = Readonly<CanvakitDefinition>;
+
+export type { CanvakitDefinition as C, CanvakitHandle as a };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/canvakit",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/canvakit — AIP-5 TEMPLATE.md reference implementation. A markdown + frontmatter format for templates that declare named data sources, resolve them in parallel, and re-render when data changes.",
+  "keywords": [
+    "agentproto",
+    "aip-5",
+    "canvakit",
+    "defineCanvakit",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-5",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/canvakit"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "import": "./dist/manifest/index.mjs",
+      "default": "./dist/manifest/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "zod": "^4.4.3",
+    "@agentproto/define-doctype": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}