@agentproto/intent 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/intent
+
+AIP-28 `INTENT.md` reference implementation. A markdown + frontmatter format for declaring a user-facing agent intent — the verb a user surfaces ("create image", "list PRs"). Sits between SKILL (multi-step expertise) and TOOL (atomic technical call), carrying the catalog/UX layer (label, intent, surfaces, examples) and routing one or more underlying tools, with the standard `defineIntent` entry-point signature.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-28>
+
+## Usage
+
+```ts
+import { defineIntent } from "@agentproto/intent"
+
+const x = defineIntent({
+  id: "my-intent",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-YXCUWIWF.mjs

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/intent v0.1.0-alpha
+ * AIP-28 INTENT.md `defineIntent` reference implementation.
+ */
+
+var intentFrontmatterSchema = z.object({ "name": z.any().describe("Internal display name."), "id": z.string().regex(new RegExp("^[a-z0-9][a-z0-9.\\-]{1,79}$")), "label": z.any().describe("User-facing button/menu label."), "description": z.any().describe("User-facing copy (\u2264500 chars per locale)."), "version": z.string().regex(new RegExp("^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.\\-]+)?$")), "intent": z.any().superRefine((x, ctx) => {
+  const schemas = [z.array(z.string()).min(1), z.record(z.string(), z.array(z.string()).min(1))];
+  const { errors, failed } = schemas.reduce(
+    ({ errors: errors2, failed: failed2 }, schema) => ((result) => result.error ? {
+      errors: [...errors2, ...result.error.issues],
+      failed: failed2 + 1
+    } : { errors: errors2, failed: failed2 })(
+      schema.safeParse(x)
+    ),
+    { errors: [], failed: 0 }
+  );
+  const passed = schemas.length - failed;
+  if (passed !== 1) {
+    ctx.addIssue(errors.length ? {
+      path: [],
+      code: "invalid_union",
+      errors: [errors],
+      message: "Invalid input: Should pass single schema. Passed " + passed
+    } : {
+      path: [],
+      code: "custom",
+      errors: [errors],
+      message: "Invalid input: Should pass single schema. Passed " + passed
+    });
+  }
+}).describe("Natural-language seeds an LLM matches against."), "surfaces": z.array(z.enum(["chat", "menu", "voice", "shortcut", "api"])).min(0).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }), "inputs": z.array(z.any()).optional(), "outputs": z.any().optional(), "entry": z.string().describe("Workspace-relative path to a routing implementation.").optional(), "implements": z.array(z.any()).min(1), "cost_class": z.enum(["trivial", "metered", "expensive"]).optional(), "quota_key": z.string().regex(new RegExp("^[a-z0-9][a-z0-9.\\-]{1,127}$")).optional(), "requires": z.any().optional(), "auth": z.string().describe("Workspace-relative path to a SECRETS.md (AIP-19).").optional(), "experiments": z.array(z.any()).optional(), "scope": z.enum(["app", "tier", "user", "guild", "workspace", "operator"]).optional().describe("Publication tier. Aligns with Model Access Rules v2 scope chain. Default `app`. `platform` is reserved for host-runtime defaults and MUST NOT appear in authored manifests."), "disable": z.string().regex(new RegExp("^[a-z0-9][a-z0-9.\\-]{1,79}$")).optional().describe("Intent id of a less-specific-tier intent that this manifest hides."), "preview": z.string().optional(), "tags": z.array(z.string().regex(new RegExp("^[a-z0-9][a-z0-9\\-]{0,63}$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).optional(), "examples": z.array(z.object({ "user": z.any(), "note": z.any().optional() }).strict()).optional(), "metadata": z.record(z.string(), z.any()).optional() }).strict().describe("JSON Schema for the YAML frontmatter of an AIP-28 INTENT.md manifest.");
+var defineIntent = createDoctype({
+  aip: 28,
+  name: "intent",
+  validate(def) {
+    const result = intentFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineIntent (AIP-28): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { defineIntent, intentFrontmatterSchema };
+//# sourceMappingURL=chunk-YXCUWIWF.mjs.map
+//# sourceMappingURL=chunk-YXCUWIWF.mjs.map

package/dist/chunk-YXCUWIWF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-intent.ts"],"names":["errors","failed"],"mappings":"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","file":"chunk-YXCUWIWF.mjs","sourcesContent":["/**\n * AIP-28 INTENT.md frontmatter zod schema.\n *\n * Generated from `resources/aip-28/draft/INTENT.schema.json` via\n * json-schema-to-zod. Imported by both `define-intent.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-intent.ts`'s `validate(def)` instead.\n */\n\nimport { z } from \"zod\"\n\nexport const intentFrontmatterSchema = z.object({ \"name\": z.any().describe(\"Internal display name.\"), \"id\": z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9.\\\\-]{1,79}$\")), \"label\": z.any().describe(\"User-facing button/menu label.\"), \"description\": z.any().describe(\"User-facing copy (≤500 chars per locale).\"), \"version\": z.string().regex(new RegExp(\"^\\\\d+\\\\.\\\\d+\\\\.\\\\d+(?:[-+][\\\\w.\\\\-]+)?$\")), \"intent\": z.any().superRefine((x, ctx) => {\n    const schemas = [z.array(z.string()).min(1), z.record(z.string(), z.array(z.string()).min(1))];\n    const { errors, failed } = schemas.reduce<{\n      errors: z.core.$ZodIssue[];\n      failed: number;\n    }>(\n      ({ errors, failed }, schema) =>\n        ((result) =>\n          result.error\n            ? {\n                errors: [...errors, ...result.error.issues],\n                failed: failed + 1,\n              }\n            : { errors, failed })(\n          schema.safeParse(x),\n        ),\n      { errors: [], failed: 0 },\n    );\n    const passed = schemas.length - failed;\n    if (passed !== 1) {\n      ctx.addIssue(errors.length ? {\n        path: [],\n        code: \"invalid_union\",\n        errors: [errors],\n        message: \"Invalid input: Should pass single schema. Passed \" + passed,\n      } : {\n        path: [],\n        code: \"custom\",\n        errors: [errors],\n        message: \"Invalid input: Should pass single schema. Passed \" + passed,\n      });\n    }\n  }).describe(\"Natural-language seeds an LLM matches against.\"), \"surfaces\": z.array(z.enum([\"chat\",\"menu\",\"voice\",\"shortcut\",\"api\"])).min(0).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }), \"inputs\": z.array(z.any()).optional(), \"outputs\": z.any().optional(), \"entry\": z.string().describe(\"Workspace-relative path to a routing implementation.\").optional(), \"implements\": z.array(z.any()).min(1), \"cost_class\": z.enum([\"trivial\",\"metered\",\"expensive\"]).optional(), \"quota_key\": z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9.\\\\-]{1,127}$\")).optional(), \"requires\": z.any().optional(), \"auth\": z.string().describe(\"Workspace-relative path to a SECRETS.md (AIP-19).\").optional(), \"experiments\": z.array(z.any()).optional(), \"scope\": z.enum([\"app\",\"tier\",\"user\",\"guild\",\"workspace\",\"operator\"]).optional().describe(\"Publication tier. Aligns with Model Access Rules v2 scope chain. Default `app`. `platform` is reserved for host-runtime defaults and MUST NOT appear in authored manifests.\"), \"disable\": z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9.\\\\-]{1,79}$\")).optional().describe(\"Intent id of a less-specific-tier intent that this manifest hides.\"), \"preview\": z.string().optional(), \"tags\": z.array(z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9\\\\-]{0,63}$\"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).optional(), \"examples\": z.array(z.object({ \"user\": z.any(), \"note\": z.any().optional() }).strict()).optional(), \"metadata\": z.record(z.string(), z.any()).optional() }).strict().describe(\"JSON Schema for the YAML frontmatter of an AIP-28 INTENT.md manifest.\")\n\nexport type IntentFrontmatter = z.infer<typeof intentFrontmatterSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { intentFrontmatterSchema } from \"./schema.js\"\nimport type { IntentDefinition, IntentHandle } from \"./types.js\"\n\n/**\n * AIP-28 reference implementation of `defineIntent`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineIntent (AIP-28): …\"\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 (`parseIntentManifest`), 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 */\nexport const defineIntent = createDoctype<IntentDefinition, IntentHandle>({\n  aip: 28,\n  name: \"intent\",\n  validate(def) {\n    const result = intentFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineIntent (AIP-28): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n    // TODO: spec-28-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 IntentHandle\n  },\n})\n"]}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { I as IntentDefinition } from './types-BkoMZLbu.js';
+export { a as IntentHandle } from './types-BkoMZLbu.js';
+
+/**
+ * AIP-28 reference implementation of `defineIntent`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineIntent (AIP-28): …"
+ * 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 (`parseIntentManifest`), 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.
+ */
+declare const defineIntent: (def: IntentDefinition) => Readonly<IntentDefinition>;
+
+/**
+ * @agentproto/intent — AIP-28 INTENT.md `defineIntent` reference impl.
+ *
+ * A markdown + frontmatter format for declaring a user-facing agent intent — the verb a user surfaces ("create image", "list PRs"). Sits between SKILL (multi-step expertise) and TOOL (atomic technical call), carrying the catalog/UX layer (label, intent, surfaces, examples) and routing one or more underlying tools, with the standard `defineIntent` entry-point signature.
+ *
+ * Spec: https://agentproto.sh/docs/aip-28
+ *
+ * Authoring paths:
+ *   - TS:  `defineIntent({...})` → `IntentHandle`
+ *   - MD:  `parseIntentManifest(src) → intentFromManifest({...})` → `IntentHandle`
+ */
+declare const SPEC_NAME: "agentintent/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { IntentDefinition, SPEC_NAME, SPEC_VERSION, defineIntent };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { defineIntent } from './chunk-YXCUWIWF.mjs';
+
+/**
+ * @agentproto/intent v0.1.0-alpha
+ * AIP-28 INTENT.md `defineIntent` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentintent/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":";;;;;;;;AAYO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/intent — AIP-28 INTENT.md `defineIntent` reference impl.\n *\n * A markdown + frontmatter format for declaring a user-facing agent intent — the verb a user surfaces (\"create image\", \"list PRs\"). Sits between SKILL (multi-step expertise) and TOOL (atomic technical call), carrying the catalog/UX layer (label, intent, surfaces, examples) and routing one or more underlying tools, with the standard `defineIntent` entry-point signature.\n *\n * Spec: https://agentproto.sh/docs/aip-28\n *\n * Authoring paths:\n *   - TS:  `defineIntent({...})` → `IntentHandle`\n *   - MD:  `parseIntentManifest(src) → intentFromManifest({...})` → `IntentHandle`\n */\n\nexport const SPEC_NAME = \"agentintent/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport { defineIntent } from \"./define-intent.js\"\nexport type { IntentDefinition, IntentHandle } from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { a as IntentHandle } from '../types-BkoMZLbu.js';
+
+/**
+ * AIP-28 INTENT.md frontmatter zod schema.
+ *
+ * Generated from `resources/aip-28/draft/INTENT.schema.json` via
+ * json-schema-to-zod. Imported by both `define-intent.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-intent.ts`'s `validate(def)` instead.
+ */
+
+declare const intentFrontmatterSchema: z.ZodObject<{
+    name: z.ZodAny;
+    id: z.ZodString;
+    label: z.ZodAny;
+    description: z.ZodAny;
+    version: z.ZodString;
+    intent: z.ZodAny;
+    surfaces: z.ZodArray<z.ZodEnum<{
+        chat: "chat";
+        menu: "menu";
+        voice: "voice";
+        shortcut: "shortcut";
+        api: "api";
+    }>>;
+    inputs: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    outputs: z.ZodOptional<z.ZodAny>;
+    entry: z.ZodOptional<z.ZodString>;
+    implements: z.ZodArray<z.ZodAny>;
+    cost_class: z.ZodOptional<z.ZodEnum<{
+        trivial: "trivial";
+        metered: "metered";
+        expensive: "expensive";
+    }>>;
+    quota_key: z.ZodOptional<z.ZodString>;
+    requires: z.ZodOptional<z.ZodAny>;
+    auth: z.ZodOptional<z.ZodString>;
+    experiments: z.ZodOptional<z.ZodArray<z.ZodAny>>;
+    scope: z.ZodOptional<z.ZodEnum<{
+        app: "app";
+        tier: "tier";
+        user: "user";
+        guild: "guild";
+        workspace: "workspace";
+        operator: "operator";
+    }>>;
+    disable: z.ZodOptional<z.ZodString>;
+    preview: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        user: z.ZodAny;
+        note: z.ZodOptional<z.ZodAny>;
+    }, z.core.$strict>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>;
+type IntentFrontmatter = z.infer<typeof intentFrontmatterSchema>;
+
+/**
+ * AIP-28 INTENT.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 `defineIntent` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-28/draft/INTENT.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 IntentManifest {
+    frontmatter: IntentFrontmatter;
+    body: string;
+}
+declare function parseIntentManifest(source: string): IntentManifest;
+declare function intentFromManifest(manifest: IntentManifest): IntentHandle;
+
+export { type IntentFrontmatter, type IntentManifest, intentFromManifest, intentFrontmatterSchema, parseIntentManifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { intentFrontmatterSchema, defineIntent } from '../chunk-YXCUWIWF.mjs';
+export { intentFrontmatterSchema } from '../chunk-YXCUWIWF.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/intent v0.1.0-alpha
+ * AIP-28 INTENT.md `defineIntent` reference implementation.
+ */
+function parseIntentManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseIntentManifest: missing or empty frontmatter");
+  }
+  const result = intentFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseIntentManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function intentFromManifest(manifest) {
+  return defineIntent(manifest.frontmatter);
+}
+
+export { intentFromManifest, parseIntentManifest };
+//# 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,oBAAoB,MAAA,EAAgC;AAClE,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,mDAAmD,CAAA;AAAA,EACrE;AACA,EAAA,MAAM,MAAA,GAAS,uBAAA,CAAwB,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAC5D,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,gDAAA,EAA8C,OAAO,KAAA,CAAM,MAAA,CACxD,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,mBAAmB,QAAA,EAAwC;AAKzE,EAAA,OAAO,YAAA,CAAa,SAAS,WAA0C,CAAA;AACzE","file":"index.mjs","sourcesContent":["/**\n * AIP-28 INTENT.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 `defineIntent` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-28/draft/INTENT.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 { intentFrontmatterSchema, type IntentFrontmatter } from \"../schema.js\"\nimport { defineIntent } from \"../define-intent.js\"\nimport type { IntentDefinition, IntentHandle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/intent/manifest\" or directly from \"@@agentproto/intent/schema\".\nexport { intentFrontmatterSchema, type IntentFrontmatter }\n\nexport interface IntentManifest {\n  frontmatter: IntentFrontmatter\n  body: string\n}\n\nexport function parseIntentManifest(source: string): IntentManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseIntentManifest: missing or empty frontmatter\")\n  }\n  const result = intentFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseIntentManifest: 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 intentFromManifest(manifest: IntentManifest): IntentHandle {\n  // The zod-validated frontmatter is structurally compatible with\n  // IntentDefinition; 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 defineIntent(manifest.frontmatter as unknown as IntentDefinition)\n}\n"]}

package/dist/types-BkoMZLbu.d.ts

@@ -0,0 +1,213 @@
+/**
+ * AIP-28 IntentDefinition + IntentHandle.
+ *
+ * `IntentDefinition` was generated from
+ * `resources/aip-28/draft/INTENT.schema.json` via json-schema-to-typescript.
+ * `IntentHandle` is the readonly view of the same shape; tighten it
+ * by hand for fields that get defaults applied in build().
+ */
+/**
+ * Either a plain string (treated as locale `en`) or a per-locale map keyed by BCP-47.
+ */
+type I18NString = string | {
+    [k: string]: string;
+};
+type ImplementsEntry = {
+    tool?: string;
+    workflow?: string;
+    entry?: string;
+    default?: boolean;
+    when?: {
+        [k: string]: PredicateValue;
+    };
+    mapping?: {
+        [k: string]: MappingValue;
+    };
+} & ImplementsEntry1 & {
+    tool?: string;
+    workflow?: string;
+    entry?: string;
+    default?: boolean;
+    when?: {
+        [k: string]: PredicateValue;
+    };
+    mapping?: {
+        [k: string]: MappingValue;
+    };
+} & ImplementsEntry1 & {
+    tool?: string;
+    workflow?: string;
+    entry?: string;
+    default?: boolean;
+    when?: {
+        [k: string]: PredicateValue;
+    };
+    mapping?: {
+        [k: string]: MappingValue;
+    };
+} & ImplementsEntry1 & {
+    tool?: string;
+    workflow?: string;
+    entry?: string;
+    default?: boolean;
+    when?: {
+        [k: string]: PredicateValue;
+    };
+    mapping?: {
+        [k: string]: MappingValue;
+    };
+} & ImplementsEntry1;
+/**
+ * Value shape for `when` and `depends_on`. Literal value, or comparison object.
+ */
+type PredicateValue = unknown | {
+    not?: unknown;
+    in?: unknown[];
+    not_in?: unknown[];
+    not_empty?: boolean;
+    gt?: number;
+    lt?: number;
+    gte?: number;
+    lte?: number;
+};
+type MappingValue = string | {
+    from: string;
+    /**
+     * Named transformer exported by the entry.
+     */
+    transform?: string;
+};
+type ImplementsEntry1 = {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+} | {
+    [k: string]: unknown;
+};
+/**
+ * JSON Schema for the YAML frontmatter of an AIP-28 INTENT.md manifest.
+ */
+interface IntentDefinition {
+    /**
+     * Internal display name.
+     */
+    name: string | {
+        [k: string]: string;
+    };
+    id: string;
+    /**
+     * User-facing button/menu label.
+     */
+    label: string | {
+        [k: string]: string;
+    };
+    /**
+     * User-facing copy (≤500 chars per locale).
+     */
+    description: string | {
+        [k: string]: string;
+    };
+    version: string;
+    /**
+     * Natural-language seeds an LLM matches against.
+     */
+    intent: [string, ...string[]] | {
+        /**
+         * @minItems 1
+         */
+        [k: string]: [string, ...string[]];
+    };
+    /**
+     * @minItems 0
+     */
+    surfaces: ("chat" | "menu" | "voice" | "shortcut" | "api")[];
+    inputs?: InputField[];
+    outputs?: Outputs;
+    /**
+     * Workspace-relative path to a routing implementation.
+     */
+    entry?: string;
+    /**
+     * @minItems 1
+     */
+    implements: [ImplementsEntry, ...ImplementsEntry[]];
+    cost_class?: "trivial" | "metered" | "expensive";
+    quota_key?: string;
+    requires?: Capabilities;
+    /**
+     * Workspace-relative path to a SECRETS.md (AIP-19).
+     */
+    auth?: string;
+    experiments?: ExperimentArm[];
+    /**
+     * Publication tier. Aligns with Model Access Rules v2 scope chain.
+     * Default `app`. `platform` is reserved for host-runtime defaults
+     * and MUST NOT appear in authored manifests.
+     *
+     * See AIP-28 § Scope and publication for the seven tiers, the
+     * specificity ranks, and the authoring-permission gates per tier.
+     */
+    scope?: "app" | "tier" | "user" | "guild" | "workspace" | "operator";
+    /**
+     * Intent id of a less-specific-tier intent that this manifest hides.
+     * Used when a higher-tier scope wants to remove a lower-tier intent
+     * without re-implementing it.
+     */
+    disable?: string;
+    preview?: string;
+    tags?: string[];
+    examples?: {
+        user: I18NString;
+        note?: I18NString;
+    }[];
+    metadata?: {};
+}
+interface InputField {
+    name: string;
+    label: I18NString;
+    type: "text" | "textarea" | "number" | "toggle" | "choice" | "multi-choice" | "file" | "image" | "date" | "markdown" | "code" | "ref";
+    placeholder?: I18NString;
+    hint?: I18NString;
+    required?: boolean;
+    default?: unknown;
+    min?: number;
+    max?: number;
+    min_length?: number;
+    max_length?: number;
+    pattern?: string;
+    /**
+     * For choice / multi-choice. Either a list of strings or a list of {value,label} objects.
+     */
+    values?: string[] | {
+        value: unknown;
+        label: I18NString;
+    }[];
+    accept?: string[];
+    language?: string;
+    depends_on?: {
+        [k: string]: unknown;
+    };
+}
+interface Outputs {
+    type: "text" | "image" | "markdown" | "file" | "custom";
+    template?: string;
+}
+interface Capabilities {
+    network?: string[];
+    secrets?: string[];
+    tools?: string[];
+}
+interface ExperimentArm {
+    id: string;
+    weight: number;
+    when?: {
+        [k: string]: PredicateValue;
+    };
+    /**
+     * @minItems 1
+     */
+    implements: [ImplementsEntry, ...ImplementsEntry[]];
+}
+type IntentHandle = Readonly<IntentDefinition>;
+
+export type { IntentDefinition as I, IntentHandle as a };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/intent",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/intent — AIP-28 INTENT.md reference implementation. A markdown + frontmatter format for declaring a user-facing agent intent — the verb a user surfaces (\"create image\", \"list PRs\"). Sits between SKILL (multi-step expertise) and TOOL (atomic technical call), carrying the catalog/UX layer (label, intent, surfaces, examples) and routing one or more underlying tools, with the standard `defineIntent` entry-point signature.",
+  "keywords": [
+    "agentproto",
+    "aip-28",
+    "intent",
+    "defineIntent",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-28",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/intent"
+  },
+  "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"
+  }
+}