@agentproto/routine 0.1.0-alpha.1

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/routine
+
+AIP-41 `ROUTINE.md` reference implementation. A markdown + frontmatter format for declaring a recurring or event-driven invocation of an action, workflow, or tool. Decouples "when" (the schedule) from "what" (the target). Supports cron / interval / calendar / manual / event-driven schedules, with retry, jitter, catchup policy, identity attribution, and failure routing.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-41>
+
+## Usage
+
+```ts
+import { defineRoutine } from "@agentproto/routine"
+
+const x = defineRoutine({
+  id: "my-routine",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-EIXUDVBW.mjs

@@ -0,0 +1,47 @@
+import matter from 'gray-matter';
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/routine v0.1.0-alpha
+ * AIP-41 ROUTINE.md `defineRoutine` reference implementation.
+ */
+
+var routineFrontmatterSchema = z.object({ "schema": z.literal("routine/v1"), "id": z.string().regex(new RegExp("^[a-z0-9@][a-z0-9.@/_-]*$")).min(2).max(80).describe("Machine identifier. Lowercase, digits, dashes, dots, optional @owner/ prefix. Unique within the registry that hosts the routine."), "description": z.string().min(1).max(2e3).describe("One-paragraph purpose."), "version": z.string().regex(new RegExp("^\\d+\\.\\d+\\.\\d+(?:[-+][\\w.\\-]+)?$")).describe("Spec version of THIS file.").default("1.0.0"), "schedule": z.any().describe("When the routine fires."), "target": z.any().describe("What the routine invokes when it fires."), "identity": z.any().describe("Identity that owns the routine fire (AIP-23). Defaults to host policy.").optional(), "retry": z.any().describe("Retry behaviour on failure.").optional(), "on_failure": z.any().describe("Where to route failures after retries exhaust.").optional(), "history": z.any().describe("Run history retention.").optional(), "fires_events": z.array(z.string().min(1)).describe("AIP-37 LIFECYCLE event names this routine fires.").default(["routine-triggered", "routine-completed", "routine-failed"]), "enabled": z.boolean().describe("If false, routine registers but does not fire. Useful for staging.").default(true), "tags": z.array(z.string()).describe("Free-form discovery tags.").default([]), "metadata": z.record(z.string(), z.any()).describe("Free-form, namespaced.").optional() }).strict().describe("Validates the YAML frontmatter portion of an AIP-41 ROUTINE.md manifest. Decouples 'when' (schedule) from 'what' (target action/workflow/tool).");
+var defineRoutine = createDoctype({
+  aip: 41,
+  name: "routine",
+  validate(def) {
+    const result = routineFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineRoutine (AIP-41): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+// src/manifest/index.ts
+function parseRoutineManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseRoutineManifest: missing or empty frontmatter");
+  }
+  const result = routineFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseRoutineManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function routineFromManifest(manifest) {
+  return defineRoutine(manifest.frontmatter);
+}
+
+export { defineRoutine, parseRoutineManifest, routineFromManifest, routineFrontmatterSchema };
+//# sourceMappingURL=chunk-EIXUDVBW.mjs.map
+//# sourceMappingURL=chunk-EIXUDVBW.mjs.map

package/dist/chunk-EIXUDVBW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-routine.ts","../src/manifest/index.ts"],"names":[],"mappings":"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","file":"chunk-EIXUDVBW.mjs","sourcesContent":["/**\n * AIP-41 ROUTINE.md frontmatter zod schema.\n *\n * Generated from `resources/aip-41/draft/ROUTINE.schema.json` via\n * json-schema-to-zod. Imported by both `define-routine.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-routine.ts`'s `validate(def)` instead.\n */\n\nimport { z } from \"zod\"\n\nexport const routineFrontmatterSchema = z.object({ \"schema\": z.literal(\"routine/v1\"), \"id\": z.string().regex(new RegExp(\"^[a-z0-9@][a-z0-9.@/_-]*$\")).min(2).max(80).describe(\"Machine identifier. Lowercase, digits, dashes, dots, optional @owner/ prefix. Unique within the registry that hosts the routine.\"), \"description\": z.string().min(1).max(2000).describe(\"One-paragraph purpose.\"), \"version\": z.string().regex(new RegExp(\"^\\\\d+\\\\.\\\\d+\\\\.\\\\d+(?:[-+][\\\\w.\\\\-]+)?$\")).describe(\"Spec version of THIS file.\").default(\"1.0.0\"), \"schedule\": z.any().describe(\"When the routine fires.\"), \"target\": z.any().describe(\"What the routine invokes when it fires.\"), \"identity\": z.any().describe(\"Identity that owns the routine fire (AIP-23). Defaults to host policy.\").optional(), \"retry\": z.any().describe(\"Retry behaviour on failure.\").optional(), \"on_failure\": z.any().describe(\"Where to route failures after retries exhaust.\").optional(), \"history\": z.any().describe(\"Run history retention.\").optional(), \"fires_events\": z.array(z.string().min(1)).describe(\"AIP-37 LIFECYCLE event names this routine fires.\").default([\"routine-triggered\",\"routine-completed\",\"routine-failed\"]), \"enabled\": z.boolean().describe(\"If false, routine registers but does not fire. Useful for staging.\").default(true), \"tags\": z.array(z.string()).describe(\"Free-form discovery tags.\").default([] as never), \"metadata\": z.record(z.string(), z.any()).describe(\"Free-form, namespaced.\").optional() }).strict().describe(\"Validates the YAML frontmatter portion of an AIP-41 ROUTINE.md manifest. Decouples 'when' (schedule) from 'what' (target action/workflow/tool).\")\n\nexport type RoutineFrontmatter = z.infer<typeof routineFrontmatterSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { routineFrontmatterSchema } from \"./schema.js\"\nimport type { RoutineDefinition, RoutineHandle } from \"./types.js\"\n\n/**\n * AIP-41 reference implementation of `defineRoutine`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineRoutine (AIP-41): …\"\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 (`parseRoutineManifest`), 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 defineRoutine = createDoctype<RoutineDefinition, RoutineHandle>({\n  aip: 41,\n  name: \"routine\",\n  validate(def) {\n    const result = routineFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineRoutine (AIP-41): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n    // TODO: spec-41-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 RoutineHandle\n  },\n})\n","/**\n * AIP-41 ROUTINE.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 `defineRoutine` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-41/draft/ROUTINE.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 { routineFrontmatterSchema, type RoutineFrontmatter } from \"../schema.js\"\nimport { defineRoutine } from \"../define-routine.js\"\nimport type { RoutineDefinition, RoutineHandle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/routine/manifest\" or directly from \"@@agentproto/routine/schema\".\nexport { routineFrontmatterSchema, type RoutineFrontmatter }\n\nexport interface RoutineManifest {\n  frontmatter: RoutineFrontmatter\n  body: string\n}\n\nexport function parseRoutineManifest(source: string): RoutineManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseRoutineManifest: missing or empty frontmatter\")\n  }\n  const result = routineFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseRoutineManifest: 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 routineFromManifest(manifest: RoutineManifest): RoutineHandle {\n  // The zod-validated frontmatter is structurally compatible with\n  // RoutineDefinition; 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 defineRoutine(manifest.frontmatter as unknown as RoutineDefinition)\n}\n"]}

package/dist/index-C6hgOdlW.d.ts

@@ -0,0 +1,261 @@
+import { z } from 'zod';
+
+/**
+ * AIP-41 RoutineDefinition + RoutineHandle.
+ *
+ * `RoutineDefinition` was generated from
+ * `resources/aip-41/draft/ROUTINE.schema.json` via json-schema-to-typescript.
+ * `RoutineHandle` is the readonly view of the same shape; tighten it
+ * by hand for fields that get defaults applied in build().
+ */
+type IdentityRef = string | {
+    ref?: string;
+    file?: string;
+    inline?: {
+        name?: string;
+        email?: string;
+    };
+    [k: string]: unknown;
+};
+/**
+ * Validates the YAML frontmatter portion of an AIP-41 ROUTINE.md manifest. Decouples 'when' (schedule) from 'what' (target action/workflow/tool).
+ */
+interface RoutineDefinition {
+    schema: "routine/v1";
+    /**
+     * Machine identifier. Lowercase, digits, dashes, dots, optional @owner/ prefix. Unique within the registry that hosts the routine.
+     */
+    id: string;
+    /**
+     * One-paragraph purpose.
+     */
+    description: string;
+    /**
+     * Spec version of THIS file.
+     */
+    version?: string;
+    /**
+     * When the routine fires.
+     */
+    schedule: ScheduleCron | ScheduleInterval | ScheduleCalendar | ScheduleManual | ScheduleEvent;
+    /**
+     * What the routine invokes when it fires.
+     */
+    target: TargetAction | TargetWorkflow | TargetTool;
+    /**
+     * Identity that owns the routine fire (AIP-23). Defaults to host policy.
+     */
+    identity?: string | {
+        ref?: string;
+        file?: string;
+        inline?: {
+            name?: string;
+            email?: string;
+        };
+        [k: string]: unknown;
+    };
+    retry?: Retry;
+    on_failure?: OnFailure;
+    history?: History;
+    /**
+     * AIP-37 LIFECYCLE event names this routine fires.
+     */
+    fires_events?: string[];
+    /**
+     * If false, routine registers but does not fire. Useful for staging.
+     */
+    enabled?: boolean;
+    /**
+     * Free-form discovery tags.
+     */
+    tags?: string[];
+    /**
+     * Free-form, namespaced.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+}
+interface ScheduleCron {
+    kind: "cron";
+    /**
+     * Standard 5-field cron expression.
+     */
+    cron: string;
+    /**
+     * IANA tz database name. Legacy abbreviations rejected.
+     */
+    timezone?: string;
+    jitter_seconds?: number;
+    catchup?: "skip" | "one" | "all";
+}
+interface ScheduleInterval {
+    kind: "interval";
+    /**
+     * Duration: Ns | Nm | Nh | Nd.
+     */
+    every: string;
+    /**
+     * OPTIONAL anchor; default = registration time.
+     */
+    from?: string;
+    jitter_seconds?: number;
+}
+interface ScheduleCalendar {
+    kind: "calendar";
+    /**
+     * RFC 5545 RRULE.
+     */
+    rrule: string;
+    timezone?: string;
+}
+interface ScheduleManual {
+    kind: "manual";
+}
+interface ScheduleEvent {
+    kind: "event";
+    /**
+     * AIP-37 LIFECYCLE event name.
+     */
+    on: string;
+    /**
+     * OPTIONAL — only fire if event payload matches filter.
+     */
+    filter?: {
+        [k: string]: unknown;
+    };
+}
+interface TargetAction {
+    /**
+     * AIP-39 ACTION ref. Resolver picks tool implementation.
+     */
+    action: string;
+    /**
+     * Invocation payload. May reference ${{ vault.* }} and ${{ now }}.
+     */
+    inputs?: {
+        [k: string]: unknown;
+    };
+}
+interface TargetWorkflow {
+    /**
+     * AIP-15 WORKFLOW ref.
+     */
+    workflow: string | AnyRef;
+    inputs?: {
+        [k: string]: unknown;
+    };
+}
+/**
+ * AIP-27 ref primitive — exactly one of ref|file|inline.
+ */
+interface AnyRef {
+    ref?: string;
+    file?: string;
+    inline?: {
+        [k: string]: unknown;
+    };
+}
+interface TargetTool {
+    /**
+     * AIP-14 TOOL id (pin specific implementation).
+     */
+    tool: string;
+    inputs?: {
+        [k: string]: unknown;
+    };
+}
+/**
+ * Retry behaviour on failure.
+ */
+interface Retry {
+    max_attempts?: number;
+    backoff?: "exponential" | "linear" | "fixed";
+    initial_ms?: number;
+    max_ms?: number;
+    /**
+     * OPTIONAL — only retry these failure classes.
+     */
+    on?: string[];
+}
+/**
+ * Where to route failures after retries exhaust.
+ */
+interface OnFailure {
+    /**
+     * Identity-refs to notify.
+     */
+    notify?: IdentityRef[];
+    /**
+     * Open AIP-13/20 WORK item on retry-exhausted failure.
+     */
+    create_work_item?: boolean;
+    /**
+     * OPTIONAL custom AIP-37 event to fire on failure.
+     */
+    fire_event?: string;
+}
+/**
+ * Run history retention.
+ */
+interface History {
+    retain_runs?: number;
+    retain_failed?: number;
+}
+type RoutineHandle = Readonly<RoutineDefinition>;
+
+/**
+ * AIP-41 ROUTINE.md frontmatter zod schema.
+ *
+ * Generated from `resources/aip-41/draft/ROUTINE.schema.json` via
+ * json-schema-to-zod. Imported by both `define-routine.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-routine.ts`'s `validate(def)` instead.
+ */
+
+declare const routineFrontmatterSchema: z.ZodObject<{
+    schema: z.ZodLiteral<"routine/v1">;
+    id: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodDefault<z.ZodString>;
+    schedule: z.ZodAny;
+    target: z.ZodAny;
+    identity: z.ZodOptional<z.ZodAny>;
+    retry: z.ZodOptional<z.ZodAny>;
+    on_failure: z.ZodOptional<z.ZodAny>;
+    history: z.ZodOptional<z.ZodAny>;
+    fires_events: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>;
+type RoutineFrontmatter = z.infer<typeof routineFrontmatterSchema>;
+
+/**
+ * AIP-41 ROUTINE.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 `defineRoutine` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-41/draft/ROUTINE.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 RoutineManifest {
+    frontmatter: RoutineFrontmatter;
+    body: string;
+}
+declare function parseRoutineManifest(source: string): RoutineManifest;
+declare function routineFromManifest(manifest: RoutineManifest): RoutineHandle;
+
+export { type RoutineDefinition as R, type RoutineHandle as a, type RoutineManifest as b, routineFrontmatterSchema as c, type RoutineFrontmatter as d, parseRoutineManifest as p, routineFromManifest as r };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { R as RoutineDefinition, a as RoutineHandle } from './index-C6hgOdlW.js';
+export { b as RoutineManifest, p as parseRoutineManifest, r as routineFromManifest, c as routineFrontmatterSchema } from './index-C6hgOdlW.js';
+import * as _agentproto_manifest from '@agentproto/manifest';
+import { DoctypeSpec } from '@agentproto/manifest';
+import 'zod';
+
+/**
+ * AIP-41 reference implementation of `defineRoutine`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineRoutine (AIP-41): …"
+ * 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 (`parseRoutineManifest`), 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 defineRoutine: (def: RoutineDefinition) => Readonly<RoutineDefinition>;
+
+declare const routineSpec: DoctypeSpec<RoutineDefinition, RoutineHandle>;
+declare const routineVerbs: _agentproto_manifest.Verbs<RoutineDefinition, Readonly<RoutineDefinition>>;
+
+/**
+ * @agentproto/routine — AIP-41 ROUTINE.md `defineRoutine` reference impl.
+ *
+ * A markdown + frontmatter format for declaring a recurring or event-driven invocation of an action, workflow, or tool. Decouples "when" (the schedule) from "what" (the target). Supports cron / interval / calendar / manual / event-driven schedules, with retry, jitter, catchup policy, identity attribution, and failure routing.
+ *
+ * Spec: https://agentproto.sh/docs/aip-41
+ *
+ * Authoring paths:
+ *   - TS:  `defineRoutine({...})` → `RoutineHandle`
+ *   - MD:  `parseRoutineManifest(src) → routineFromManifest({...})` → `RoutineHandle`
+ */
+declare const SPEC_NAME: "agentroutine/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { RoutineDefinition, RoutineHandle, SPEC_NAME, SPEC_VERSION, defineRoutine, routineSpec, routineVerbs };

package/dist/index.mjs

@@ -0,0 +1,31 @@
+import { defineRoutine, parseRoutineManifest } from './chunk-EIXUDVBW.mjs';
+export { defineRoutine, parseRoutineManifest, routineFromManifest, routineFrontmatterSchema } from './chunk-EIXUDVBW.mjs';
+import { createVerbs } from '@agentproto/manifest';
+
+/**
+ * @agentproto/routine v0.1.0-alpha
+ * AIP-41 ROUTINE.md `defineRoutine` reference implementation.
+ */
+var routineSpec = {
+  name: "routine",
+  aip: 41,
+  schemaLiteral: "routine/v1",
+  pathOf: (h) => `.routines/${h.id}/ROUTINE.md`,
+  define: defineRoutine,
+  parse: (source) => {
+    const m = parseRoutineManifest(source);
+    return {
+      frontmatter: m.frontmatter,
+      body: m.body
+    };
+  }
+};
+var routineVerbs = createVerbs(routineSpec);
+
+// src/index.ts
+var SPEC_NAME = "agentroutine/v1";
+var SPEC_VERSION = "1.0.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION, routineSpec, routineVerbs };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/spec.ts","../src/index.ts"],"names":[],"mappings":";;;;;;;;AAYO,IAAM,WAAA,GAA6D;AAAA,EACxE,IAAA,EAAM,SAAA;AAAA,EACN,GAAA,EAAK,EAAA;AAAA,EACL,aAAA,EAAe,YAAA;AAAA,EACf,MAAA,EAAQ,CAAC,CAAA,KAAM,CAAA,UAAA,EAAa,EAAE,EAAE,CAAA,WAAA,CAAA;AAAA,EAChC,MAAA,EAAQ,aAAA;AAAA,EACR,KAAA,EAAO,CAAC,MAAA,KAAW;AACjB,IAAA,MAAM,CAAA,GAAI,qBAAqB,MAAM,CAAA;AACrC,IAAA,OAAO;AAAA,MACL,aAAa,CAAA,CAAE,WAAA;AAAA,MACf,MAAM,CAAA,CAAE;AAAA,KACV;AAAA,EACF;AACF;AAEO,IAAM,YAAA,GAAe,YAAY,WAAW;;;ACf5C,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * AIP-41 doctype spec — fed to `@agentproto/manifest.createVerbs`\n * to derive create / load / list / update / resolve / delete in one\n * place. Plugs into `@agentproto/mcp-server` so a routine library\n * lives at `<workspace>/.routines/<id>/ROUTINE.md`.\n */\n\nimport { createVerbs, type DoctypeSpec } from \"@agentproto/manifest\"\nimport { defineRoutine } from \"./define-routine.js\"\nimport { parseRoutineManifest } from \"./manifest/index.js\"\nimport type { RoutineDefinition, RoutineHandle } from \"./types.js\"\n\nexport const routineSpec: DoctypeSpec<RoutineDefinition, RoutineHandle> = {\n  name: \"routine\",\n  aip: 41,\n  schemaLiteral: \"routine/v1\",\n  pathOf: (h) => `.routines/${h.id}/ROUTINE.md`,\n  define: defineRoutine,\n  parse: (source) => {\n    const m = parseRoutineManifest(source)\n    return {\n      frontmatter: m.frontmatter as unknown as Record<string, unknown>,\n      body: m.body,\n    }\n  },\n}\n\nexport const routineVerbs = createVerbs(routineSpec)\n","/**\n * @agentproto/routine — AIP-41 ROUTINE.md `defineRoutine` reference impl.\n *\n * A markdown + frontmatter format for declaring a recurring or event-driven invocation of an action, workflow, or tool. Decouples \"when\" (the schedule) from \"what\" (the target). Supports cron / interval / calendar / manual / event-driven schedules, with retry, jitter, catchup policy, identity attribution, and failure routing.\n *\n * Spec: https://agentproto.sh/docs/aip-41\n *\n * Authoring paths:\n *   - TS:  `defineRoutine({...})` → `RoutineHandle`\n *   - MD:  `parseRoutineManifest(src) → routineFromManifest({...})` → `RoutineHandle`\n */\n\nexport const SPEC_NAME = \"agentroutine/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport { defineRoutine } from \"./define-routine.js\"\nexport type { RoutineDefinition, RoutineHandle } from \"./types.js\"\nexport { routineSpec, routineVerbs } from \"./spec.js\"\nexport {\n  parseRoutineManifest,\n  routineFromManifest,\n  routineFrontmatterSchema,\n  type RoutineManifest,\n} from \"./manifest/index.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,2 @@
+export { d as RoutineFrontmatter, b as RoutineManifest, p as parseRoutineManifest, r as routineFromManifest, c as routineFrontmatterSchema } from '../index-C6hgOdlW.js';
+import 'zod';

package/dist/manifest/index.mjs

@@ -0,0 +1,3 @@
+export { parseRoutineManifest, routineFromManifest, routineFrontmatterSchema } from '../chunk-EIXUDVBW.mjs';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/manifest/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@agentproto/routine",
+  "version": "0.1.0-alpha.1",
+  "description": "@agentproto/routine — AIP-41 ROUTINE.md reference implementation. A markdown + frontmatter format for declaring a recurring or event-driven invocation of an action, workflow, or tool. Decouples \"when\" (the schedule) from \"what\" (the target). Supports cron / interval / calendar / manual / event-driven schedules, with retry, jitter, catchup policy, identity attribution, and failure routing.",
+  "keywords": [
+    "agentproto",
+    "aip-41",
+    "routine",
+    "defineRoutine",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-41",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/routine"
+  },
+  "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/manifest": "0.1.0-alpha.1",
+    "@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"
+  }
+}