@agentproto/persona 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/persona
+
+AIP-25 `PERSONA.md` reference implementation. A single-doc markdown + frontmatter format for portable agent personas — the public face, voice register, backstory, and boundaries of a character — sibling to AIP-23 IDENTITY (heavy substance) and building block of AIP-24 ASSEMBLY.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-25>
+
+## Usage
+
+```ts
+import { definePersona } from "@agentproto/persona"
+
+const x = definePersona({
+  id: "my-persona",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-TMV2PWI4.mjs

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/persona v0.1.0-alpha
+ * AIP-25 PERSONA.md `definePersona` reference implementation.
+ */
+
+var personaFrontmatterSchema = z.object({ "schema": z.literal("persona/v1").describe("Schema dispatch tag. MUST be 'persona/v1' for this version of AIP-25."), "name": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).min(2).max(64).describe("Machine identifier. Lowercase, digits, dashes. Must start with a letter, end with a letter or digit. Unique within the registry that hosts the persona."), "title": z.string().min(1).max(120).describe("Human-readable display title, sentence case."), "description": z.string().min(1).max(2e3).describe("One-paragraph elevator pitch. The persona's purpose, audience, and shape."), "version": z.string().regex(new RegExp("^\\d+\\.\\d+\\.\\d+(?:[-+][a-zA-Z0-9.-]+)?$")).describe("Semver. Bump on breaking change to identity, voice, or boundaries."), "extends": z.string().regex(new RegExp("^(\\.{1,2}/)[^\\s]+PERSONA\\.md$")).describe("Relative path to a parent PERSONA.md. Triggers composition. Path MUST end in 'PERSONA.md'.").optional(), "avatar": z.string().min(1).describe("Public visual face. URL, data URI, or 'ws://avatars/<slug>' ref. Schema does not validate scheme; the loader resolves.").optional(), "backstory": z.object({ "oneLineHook": z.string().min(1).max(280).describe("Punchy elevator hook. One sentence the catalog can show next to the persona name.").optional(), "background": z.string().min(1).describe("Long-form lore prose, in markdown. The character's history, motivations, and context.").optional(), "archetypes": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$"))).max(12).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Categorical archetype labels. Lowercase kebab-case. Examples: mentor, craftsman, sentinel, trickster. The catalog MAY cluster by these.").default([]), "era": z.string().min(1).max(80).describe("Free-form era label. Conventional values: 'contemporary', 'timeless', '<year>', '<year>-<year>', '<period>'. Free-form to accept any setting.").optional(), "setting": z.string().min(1).max(120).describe("Free-form setting label. Conventional values: 'real-world', 'fictional-<universe>'. Free-form to accept any setting.").optional() }).strict().default({}), "voice": z.object({ "register": z.string().min(1).max(80).describe("Voice register. Conventional values: warm-direct, playful, terse, academic. Custom values welcome \u2014 free-form to accept any author label.").optional(), "signaturePhrases": z.array(z.string().min(1).max(200)).max(24).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Catchphrases the character uses. Append-and-dedupe under extends \u2014 lineage accumulates phrases.").default([]), "tonality": z.array(z.string().min(1).max(60)).max(16).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Tonal adjectives. Examples: rigorous, encouraging, dry, warm. Append-and-dedupe under extends.").default([]), "formality": z.number().int().gte(0).lte(10).describe("Formality scale, 0 (extremely casual) to 10 (extremely formal). Optional.").optional(), "emojiUsage": z.enum(["never", "sparing", "frequent"]).describe("Emoji posture. 'never' = no emojis ever; 'sparing' = occasional, intentional; 'frequent' = part of the voice.").optional(), "signOff": z.string().min(1).max(200).describe("Sign-off the persona uses to close messages. Examples: '\u2014M.', 'Yours, Marcus', 'Until next time'.").optional() }).strict().default({}), "boundaries": z.object({ "refuses": z.array(z.string().min(1).max(200)).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Topics the persona refuses outright. Free-form prose; the persona body SHOULD demonstrate the refusal posture in voice samples. Append-and-dedupe under extends.").default([]), "defers": z.array(z.string().min(1).max(200)).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Topics the persona defers to a specialist on. Append-and-dedupe under extends.").default([]), "redirects": z.array(z.object({ "topic": z.string().min(1).max(200).describe("The topic the persona redirects."), "to": z.string().regex(new RegExp("^(ws://(personas|operators|skills)/[^\\s]+|\\.{1,2}/[^\\s]+)$")).describe("Redirect target. ws:// ref to a persona/operator/skill, or a relative path."), "notes": z.string().min(1).max(500).describe("Optional prose describing why the redirect exists.").optional() }).strict()).describe("Topic-to-target redirects. Merge-by-`topic` under extends \u2014 child entry with same topic replaces parent's.").default([]) }).strict().default({}), "defaultLocale": z.string().regex(new RegExp("^[a-z]{2,3}(-[A-Z][a-zA-Z0-9]+)*(-[A-Z]{2})?(-[a-zA-Z0-9]+)*$")).describe("BCP-47 locale tag. Examples: 'en', 'en-US', 'fr-FR', 'pt-BR'.").optional(), "multilingual": z.array(z.string().regex(new RegExp("^[a-z]{2,3}(-[A-Z][a-zA-Z0-9]+)*(-[A-Z]{2})?(-[a-zA-Z0-9]+)*$"))).max(32).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Fallback locales. BCP-47. Append-and-dedupe under extends.").default([]), "relationships": z.array(z.object({ "persona": z.string().regex(new RegExp("^ws://personas/[^\\s]+$")).describe("ws:// ref to another persona/v1 manifest in the registry."), "kind": z.string().min(1).max(60).describe("Relationship kind. Conventional values: mentor-of, peer-of, mentee-of, rival-of, partner-of. Free-form to accept any author label."), "notes": z.string().min(1).max(1e3).describe("Optional prose describing the relationship.").optional() }).strict()).describe("Named relationships to other personas. Merge-by-`persona` under extends \u2014 child entry with same ref replaces parent's.").default([]), "identity": z.string().regex(new RegExp("^ws://identities/[^\\s]+$")).describe("Optional AIP-23 identity workspace ref. The persona's inner substance.").optional(), "appliesTo": z.array(z.string().regex(new RegExp("^(ws://(operators|skills|assemblies/[a-z0-9-]+|personas)/[^\\s]+|\\.\\./[^\\s]+)$")).describe("Cross-AIP ref. Operator (AIP-9), skill (AIP-3), assembly seat (AIP-24), or relative path.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Bind this persona to specific consumers. Local-only \u2014 not inherited under extends.").default([]), "tags": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*$"))).max(16).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Catalog tags. Lowercase kebab-case. Append-and-dedupe under extends.").default([]), "metadata": z.record(z.string(), z.any()).describe("Vendor extensions, namespaced under <vendor>. Hosts MUST tolerate unknown keys; vendor namespaces MUST NOT override the meaning of fields defined in this AIP.").default({}) }).strict().describe("Validates the YAML frontmatter portion of an AIP-25 PERSONA.md manifest. Single-doc, no oneOf \u2014 every persona is the same shape. The body is markdown and not validated by this schema.");
+var definePersona = createDoctype({
+  aip: 25,
+  name: "persona",
+  readIdentity: (def) => def.name,
+  validate(def) {
+    const result = personaFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `definePersona (AIP-25): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { definePersona, personaFrontmatterSchema };
+//# sourceMappingURL=chunk-TMV2PWI4.mjs.map
+//# sourceMappingURL=chunk-TMV2PWI4.mjs.map

package/dist/chunk-TMV2PWI4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-persona.ts"],"names":[],"mappings":"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","file":"chunk-TMV2PWI4.mjs","sourcesContent":["/**\n * AIP-25 PERSONA.md frontmatter zod schema.\n *\n * Generated from `resources/aip-25/draft/PERSONA.schema.json` via\n * json-schema-to-zod. Imported by both `define-persona.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-persona.ts`'s `validate(def)` instead.\n */\n\nimport { z } from \"zod\"\n\nexport const personaFrontmatterSchema = z.object({ \"schema\": z.literal(\"persona/v1\").describe(\"Schema dispatch tag. MUST be 'persona/v1' for this version of AIP-25.\"), \"name\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).min(2).max(64).describe(\"Machine identifier. Lowercase, digits, dashes. Must start with a letter, end with a letter or digit. Unique within the registry that hosts the persona.\"), \"title\": z.string().min(1).max(120).describe(\"Human-readable display title, sentence case.\"), \"description\": z.string().min(1).max(2000).describe(\"One-paragraph elevator pitch. The persona's purpose, audience, and shape.\"), \"version\": z.string().regex(new RegExp(\"^\\\\d+\\\\.\\\\d+\\\\.\\\\d+(?:[-+][a-zA-Z0-9.-]+)?$\")).describe(\"Semver. Bump on breaking change to identity, voice, or boundaries.\"), \"extends\": z.string().regex(new RegExp(\"^(\\\\.{1,2}/)[^\\\\s]+PERSONA\\\\.md$\")).describe(\"Relative path to a parent PERSONA.md. Triggers composition. Path MUST end in 'PERSONA.md'.\").optional(), \"avatar\": z.string().min(1).describe(\"Public visual face. URL, data URI, or 'ws://avatars/<slug>' ref. Schema does not validate scheme; the loader resolves.\").optional(), \"backstory\": z.object({ \"oneLineHook\": z.string().min(1).max(280).describe(\"Punchy elevator hook. One sentence the catalog can show next to the persona name.\").optional(), \"background\": z.string().min(1).describe(\"Long-form lore prose, in markdown. The character's history, motivations, and context.\").optional(), \"archetypes\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\"))).max(12).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Categorical archetype labels. Lowercase kebab-case. Examples: mentor, craftsman, sentinel, trickster. The catalog MAY cluster by these.\").default([] as never), \"era\": z.string().min(1).max(80).describe(\"Free-form era label. Conventional values: 'contemporary', 'timeless', '<year>', '<year>-<year>', '<period>'. Free-form to accept any setting.\").optional(), \"setting\": z.string().min(1).max(120).describe(\"Free-form setting label. Conventional values: 'real-world', 'fictional-<universe>'. Free-form to accept any setting.\").optional() }).strict().default({} as never), \"voice\": z.object({ \"register\": z.string().min(1).max(80).describe(\"Voice register. Conventional values: warm-direct, playful, terse, academic. Custom values welcome — free-form to accept any author label.\").optional(), \"signaturePhrases\": z.array(z.string().min(1).max(200)).max(24).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Catchphrases the character uses. Append-and-dedupe under extends — lineage accumulates phrases.\").default([] as never), \"tonality\": z.array(z.string().min(1).max(60)).max(16).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Tonal adjectives. Examples: rigorous, encouraging, dry, warm. Append-and-dedupe under extends.\").default([] as never), \"formality\": z.number().int().gte(0).lte(10).describe(\"Formality scale, 0 (extremely casual) to 10 (extremely formal). Optional.\").optional(), \"emojiUsage\": z.enum([\"never\",\"sparing\",\"frequent\"]).describe(\"Emoji posture. 'never' = no emojis ever; 'sparing' = occasional, intentional; 'frequent' = part of the voice.\").optional(), \"signOff\": z.string().min(1).max(200).describe(\"Sign-off the persona uses to close messages. Examples: '—M.', 'Yours, Marcus', 'Until next time'.\").optional() }).strict().default({} as never), \"boundaries\": z.object({ \"refuses\": z.array(z.string().min(1).max(200)).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Topics the persona refuses outright. Free-form prose; the persona body SHOULD demonstrate the refusal posture in voice samples. Append-and-dedupe under extends.\").default([] as never), \"defers\": z.array(z.string().min(1).max(200)).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Topics the persona defers to a specialist on. Append-and-dedupe under extends.\").default([] as never), \"redirects\": z.array(z.object({ \"topic\": z.string().min(1).max(200).describe(\"The topic the persona redirects.\"), \"to\": z.string().regex(new RegExp(\"^(ws://(personas|operators|skills)/[^\\\\s]+|\\\\.{1,2}/[^\\\\s]+)$\")).describe(\"Redirect target. ws:// ref to a persona/operator/skill, or a relative path.\"), \"notes\": z.string().min(1).max(500).describe(\"Optional prose describing why the redirect exists.\").optional() }).strict()).describe(\"Topic-to-target redirects. Merge-by-`topic` under extends — child entry with same topic replaces parent's.\").default([] as never) }).strict().default({} as never), \"defaultLocale\": z.string().regex(new RegExp(\"^[a-z]{2,3}(-[A-Z][a-zA-Z0-9]+)*(-[A-Z]{2})?(-[a-zA-Z0-9]+)*$\")).describe(\"BCP-47 locale tag. Examples: 'en', 'en-US', 'fr-FR', 'pt-BR'.\").optional(), \"multilingual\": z.array(z.string().regex(new RegExp(\"^[a-z]{2,3}(-[A-Z][a-zA-Z0-9]+)*(-[A-Z]{2})?(-[a-zA-Z0-9]+)*$\"))).max(32).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Fallback locales. BCP-47. Append-and-dedupe under extends.\").default([] as never), \"relationships\": z.array(z.object({ \"persona\": z.string().regex(new RegExp(\"^ws://personas/[^\\\\s]+$\")).describe(\"ws:// ref to another persona/v1 manifest in the registry.\"), \"kind\": z.string().min(1).max(60).describe(\"Relationship kind. Conventional values: mentor-of, peer-of, mentee-of, rival-of, partner-of. Free-form to accept any author label.\"), \"notes\": z.string().min(1).max(1000).describe(\"Optional prose describing the relationship.\").optional() }).strict()).describe(\"Named relationships to other personas. Merge-by-`persona` under extends — child entry with same ref replaces parent's.\").default([] as never), \"identity\": z.string().regex(new RegExp(\"^ws://identities/[^\\\\s]+$\")).describe(\"Optional AIP-23 identity workspace ref. The persona's inner substance.\").optional(), \"appliesTo\": z.array(z.string().regex(new RegExp(\"^(ws://(operators|skills|assemblies/[a-z0-9-]+|personas)/[^\\\\s]+|\\\\.\\\\./[^\\\\s]+)$\")).describe(\"Cross-AIP ref. Operator (AIP-9), skill (AIP-3), assembly seat (AIP-24), or relative path.\")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Bind this persona to specific consumers. Local-only — not inherited under extends.\").default([] as never), \"tags\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\"))).max(16).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Catalog tags. Lowercase kebab-case. Append-and-dedupe under extends.\").default([] as never), \"metadata\": z.record(z.string(), z.any()).describe(\"Vendor extensions, namespaced under <vendor>. Hosts MUST tolerate unknown keys; vendor namespaces MUST NOT override the meaning of fields defined in this AIP.\").default({} as never) }).strict().describe(\"Validates the YAML frontmatter portion of an AIP-25 PERSONA.md manifest. Single-doc, no oneOf — every persona is the same shape. The body is markdown and not validated by this schema.\")\n\nexport type PersonaFrontmatter = z.infer<typeof personaFrontmatterSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { personaFrontmatterSchema } from \"./schema.js\"\nimport type { PersonaDefinition, PersonaHandle } from \"./types.js\"\n\n/**\n * AIP-25 reference implementation of `definePersona`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"definePersona (AIP-25): …\"\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 (`parsePersonaManifest`), 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: def.description.\n */\nexport const definePersona = createDoctype<PersonaDefinition, PersonaHandle>({\n  aip: 25,\n  name: \"persona\",\n  readIdentity: (def) => def.name,\n  validate(def) {\n    const result = personaFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `definePersona (AIP-25): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n    // TODO: spec-25-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 PersonaHandle\n  },\n})\n"]}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { P as PersonaDefinition } from './types-CwL32wDG.js';
+export { a as PersonaHandle } from './types-CwL32wDG.js';
+
+/**
+ * AIP-25 reference implementation of `definePersona`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "definePersona (AIP-25): …"
+ * 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 (`parsePersonaManifest`), 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: def.description.
+ */
+declare const definePersona: (def: PersonaDefinition) => Readonly<PersonaDefinition>;
+
+/**
+ * @agentproto/persona — AIP-25 PERSONA.md `definePersona` reference impl.
+ *
+ * A single-doc markdown + frontmatter format for portable agent personas — the public face, voice register, backstory, and boundaries of a character — sibling to AIP-23 IDENTITY (heavy substance) and building block of AIP-24 ASSEMBLY.
+ *
+ * Spec: https://agentproto.sh/docs/aip-25
+ *
+ * Authoring paths:
+ *   - TS:  `definePersona({...})` → `PersonaHandle`
+ *   - MD:  `parsePersonaManifest(src) → personaFromManifest({...})` → `PersonaHandle`
+ */
+declare const SPEC_NAME: "agentpersona/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { PersonaDefinition, SPEC_NAME, SPEC_VERSION, definePersona };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { definePersona } from './chunk-TMV2PWI4.mjs';
+
+/**
+ * @agentproto/persona v0.1.0-alpha
+ * AIP-25 PERSONA.md `definePersona` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentpersona/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/persona — AIP-25 PERSONA.md `definePersona` reference impl.\n *\n * A single-doc markdown + frontmatter format for portable agent personas — the public face, voice register, backstory, and boundaries of a character — sibling to AIP-23 IDENTITY (heavy substance) and building block of AIP-24 ASSEMBLY.\n *\n * Spec: https://agentproto.sh/docs/aip-25\n *\n * Authoring paths:\n *   - TS:  `definePersona({...})` → `PersonaHandle`\n *   - MD:  `parsePersonaManifest(src) → personaFromManifest({...})` → `PersonaHandle`\n */\n\nexport const SPEC_NAME = \"agentpersona/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport { definePersona } from \"./define-persona.js\"\nexport type { PersonaDefinition, PersonaHandle } from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { a as PersonaHandle } from '../types-CwL32wDG.js';
+
+/**
+ * AIP-25 PERSONA.md frontmatter zod schema.
+ *
+ * Generated from `resources/aip-25/draft/PERSONA.schema.json` via
+ * json-schema-to-zod. Imported by both `define-persona.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-persona.ts`'s `validate(def)` instead.
+ */
+
+declare const personaFrontmatterSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"persona/v1">;
+    name: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    extends: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
+    backstory: z.ZodDefault<z.ZodObject<{
+        oneLineHook: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        archetypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        era: z.ZodOptional<z.ZodString>;
+        setting: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    voice: z.ZodDefault<z.ZodObject<{
+        register: z.ZodOptional<z.ZodString>;
+        signaturePhrases: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        tonality: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        formality: z.ZodOptional<z.ZodNumber>;
+        emojiUsage: z.ZodOptional<z.ZodEnum<{
+            never: "never";
+            sparing: "sparing";
+            frequent: "frequent";
+        }>>;
+        signOff: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    boundaries: z.ZodDefault<z.ZodObject<{
+        refuses: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        defers: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        redirects: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            topic: z.ZodString;
+            to: z.ZodString;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    multilingual: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    relationships: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        persona: z.ZodString;
+        kind: z.ZodString;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    identity: z.ZodOptional<z.ZodString>;
+    appliesTo: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>;
+type PersonaFrontmatter = z.infer<typeof personaFrontmatterSchema>;
+
+/**
+ * AIP-25 PERSONA.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 `definePersona` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-25/draft/PERSONA.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 PersonaManifest {
+    frontmatter: PersonaFrontmatter;
+    body: string;
+}
+declare function parsePersonaManifest(source: string): PersonaManifest;
+declare function personaFromManifest(manifest: PersonaManifest): PersonaHandle;
+
+export { type PersonaFrontmatter, type PersonaManifest, parsePersonaManifest, personaFromManifest, personaFrontmatterSchema };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { personaFrontmatterSchema, definePersona } from '../chunk-TMV2PWI4.mjs';
+export { personaFrontmatterSchema } from '../chunk-TMV2PWI4.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/persona v0.1.0-alpha
+ * AIP-25 PERSONA.md `definePersona` reference implementation.
+ */
+function parsePersonaManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parsePersonaManifest: missing or empty frontmatter");
+  }
+  const result = personaFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parsePersonaManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function personaFromManifest(manifest) {
+  return definePersona(manifest.frontmatter);
+}
+
+export { parsePersonaManifest, personaFromManifest };
+//# 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,qBAAqB,MAAA,EAAiC;AACpE,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,oDAAoD,CAAA;AAAA,EACtE;AACA,EAAA,MAAM,MAAA,GAAS,wBAAA,CAAyB,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAC7D,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,iDAAA,EAA+C,OAAO,KAAA,CAAM,MAAA,CACzD,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,oBAAoB,QAAA,EAA0C;AAK5E,EAAA,OAAO,aAAA,CAAc,SAAS,WAA2C,CAAA;AAC3E","file":"index.mjs","sourcesContent":["/**\n * AIP-25 PERSONA.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 `definePersona` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-25/draft/PERSONA.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 { personaFrontmatterSchema, type PersonaFrontmatter } from \"../schema.js\"\nimport { definePersona } from \"../define-persona.js\"\nimport type { PersonaDefinition, PersonaHandle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/persona/manifest\" or directly from \"@@agentproto/persona/schema\".\nexport { personaFrontmatterSchema, type PersonaFrontmatter }\n\nexport interface PersonaManifest {\n  frontmatter: PersonaFrontmatter\n  body: string\n}\n\nexport function parsePersonaManifest(source: string): PersonaManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parsePersonaManifest: missing or empty frontmatter\")\n  }\n  const result = personaFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parsePersonaManifest: 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 personaFromManifest(manifest: PersonaManifest): PersonaHandle {\n  // The zod-validated frontmatter is structurally compatible with\n  // PersonaDefinition; 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 definePersona(manifest.frontmatter as unknown as PersonaDefinition)\n}\n"]}

package/dist/types-CwL32wDG.d.ts

@@ -0,0 +1,238 @@
+/**
+ * AIP-25 PersonaDefinition + PersonaHandle.
+ *
+ * `PersonaDefinition` was generated from
+ * `resources/aip-25/draft/PERSONA.schema.json` via json-schema-to-typescript.
+ * `PersonaHandle` is the readonly view of the same shape; tighten it
+ * by hand for fields that get defaults applied in build().
+ */
+/**
+ * Validates the YAML frontmatter portion of an AIP-25 PERSONA.md manifest. Single-doc, no oneOf — every persona is the same shape. The body is markdown and not validated by this schema.
+ */
+interface PersonaDefinition {
+    /**
+     * Schema dispatch tag. MUST be 'persona/v1' for this version of AIP-25.
+     */
+    schema: "persona/v1";
+    /**
+     * Machine identifier. Lowercase, digits, dashes. Must start with a letter, end with a letter or digit. Unique within the registry that hosts the persona.
+     */
+    name: string;
+    /**
+     * Human-readable display title, sentence case.
+     */
+    title: string;
+    /**
+     * One-paragraph elevator pitch. The persona's purpose, audience, and shape.
+     */
+    description: string;
+    /**
+     * Semver. Bump on breaking change to identity, voice, or boundaries.
+     */
+    version: string;
+    /**
+     * Relative path to a parent PERSONA.md. Triggers composition. Path MUST end in 'PERSONA.md'.
+     */
+    extends?: string;
+    /**
+     * Public visual face. URL, data URI, or 'ws://avatars/<slug>' ref. Schema does not validate scheme; the loader resolves.
+     */
+    avatar?: string;
+    backstory?: {
+        /**
+         * Punchy elevator hook. One sentence the catalog can show next to the persona name.
+         */
+        oneLineHook?: string;
+        /**
+         * Long-form lore prose, in markdown. The character's history, motivations, and context.
+         */
+        background?: string;
+        /**
+         * Categorical archetype labels. Lowercase kebab-case. Examples: mentor, craftsman, sentinel, trickster. The catalog MAY cluster by these.
+         *
+         * @maxItems 12
+         */
+        archetypes?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string];
+        /**
+         * Free-form era label. Conventional values: 'contemporary', 'timeless', '<year>', '<year>-<year>', '<period>'. Free-form to accept any setting.
+         */
+        era?: string;
+        /**
+         * Free-form setting label. Conventional values: 'real-world', 'fictional-<universe>'. Free-form to accept any setting.
+         */
+        setting?: string;
+    };
+    voice?: {
+        /**
+         * Voice register. Conventional values: warm-direct, playful, terse, academic. Custom values welcome — free-form to accept any author label.
+         */
+        register?: string;
+        /**
+         * Catchphrases the character uses. Append-and-dedupe under extends — lineage accumulates phrases.
+         *
+         * @maxItems 24
+         */
+        signaturePhrases?: string[];
+        /**
+         * Tonal adjectives. Examples: rigorous, encouraging, dry, warm. Append-and-dedupe under extends.
+         *
+         * @maxItems 16
+         */
+        tonality?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string
+        ] | [
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string,
+            string
+        ];
+        /**
+         * Formality scale, 0 (extremely casual) to 10 (extremely formal). Optional.
+         */
+        formality?: number;
+        /**
+         * Emoji posture. 'never' = no emojis ever; 'sparing' = occasional, intentional; 'frequent' = part of the voice.
+         */
+        emojiUsage?: "never" | "sparing" | "frequent";
+        /**
+         * Sign-off the persona uses to close messages. Examples: '—M.', 'Yours, Marcus', 'Until next time'.
+         */
+        signOff?: string;
+    };
+    boundaries?: {
+        /**
+         * Topics the persona refuses outright. Free-form prose; the persona body SHOULD demonstrate the refusal posture in voice samples. Append-and-dedupe under extends.
+         */
+        refuses?: string[];
+        /**
+         * Topics the persona defers to a specialist on. Append-and-dedupe under extends.
+         */
+        defers?: string[];
+        /**
+         * Topic-to-target redirects. Merge-by-`topic` under extends — child entry with same topic replaces parent's.
+         */
+        redirects?: {
+            /**
+             * The topic the persona redirects.
+             */
+            topic: string;
+            /**
+             * Redirect target. ws:// ref to a persona/operator/skill, or a relative path.
+             */
+            to: string;
+            /**
+             * Optional prose describing why the redirect exists.
+             */
+            notes?: string;
+        }[];
+    };
+    /**
+     * BCP-47 locale tag. Examples: 'en', 'en-US', 'fr-FR', 'pt-BR'.
+     */
+    defaultLocale?: string;
+    /**
+     * Fallback locales. BCP-47. Append-and-dedupe under extends.
+     *
+     * @maxItems 32
+     */
+    multilingual?: string[];
+    /**
+     * Named relationships to other personas. Merge-by-`persona` under extends — child entry with same ref replaces parent's.
+     */
+    relationships?: {
+        /**
+         * ws:// ref to another persona/v1 manifest in the registry.
+         */
+        persona: string;
+        /**
+         * Relationship kind. Conventional values: mentor-of, peer-of, mentee-of, rival-of, partner-of. Free-form to accept any author label.
+         */
+        kind: string;
+        /**
+         * Optional prose describing the relationship.
+         */
+        notes?: string;
+    }[];
+    /**
+     * Optional AIP-23 identity workspace ref. The persona's inner substance.
+     */
+    identity?: string;
+    /**
+     * Bind this persona to specific consumers. Local-only — not inherited under extends.
+     */
+    appliesTo?: string[];
+    /**
+     * Catalog tags. Lowercase kebab-case. Append-and-dedupe under extends.
+     *
+     * @maxItems 16
+     */
+    tags?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string
+    ] | [
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string,
+        string
+    ];
+    /**
+     * Vendor extensions, namespaced under <vendor>. Hosts MUST tolerate unknown keys; vendor namespaces MUST NOT override the meaning of fields defined in this AIP.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+}
+type PersonaHandle = Readonly<PersonaDefinition>;
+
+export type { PersonaDefinition as P, PersonaHandle as a };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/persona",
+  "version": "0.1.0-alpha.0",
+  "description": "@agentproto/persona — AIP-25 PERSONA.md reference implementation. A single-doc markdown + frontmatter format for portable agent personas — the public face, voice register, backstory, and boundaries of a character — sibling to AIP-23 IDENTITY (heavy substance) and building block of AIP-24 ASSEMBLY.",
+  "keywords": [
+    "agentproto",
+    "aip-25",
+    "persona",
+    "definePersona",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-25",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/persona"
+  },
+  "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"
+  }
+}