@cat-factory/contracts 0.6.0

package/dist/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAkB5B,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,iDAAiC,CAAA;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAMvE;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;IAErC,iCAAiC;;IAEjC,uCAAuC;;IAEvC,yDAAyD;;;;;;;;IAEzD,6CAA6C;;IAE7C,mDAAmD;;IAEnD;;;;OAIG;;aAEH,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAInF,gGAAgG;AAChG,eAAO,MAAM,oBAAoB;;IAE/B,qEAAqE;;IAErE,sDAAsD;;aAEtD,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB;IAC5B,sDAAsD;;IAEtD,2EAA2E;;IAE3E,wDAAwD;;aAExD,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,iFAAiF;AACjF,eAAO,MAAM,gBAAgB;;IAE3B,mFAAmF;;IAEnF,6BAA6B;;IAE7B,gDAAgD;;IAEhD,gDAAgD;;IAEhD,mCAAmC;;IAEnC,sDAAsD;;IAEtD,wCAAwC;;IAExC,oBAAoB;;IAEpB,6DAA6D;;IAE7D,qEAAqE;;QA9BrE,sDAAsD;;QAEtD,2EAA2E;;QAE3E,wDAAwD;;;IA4BxD,4EAA4E;;IAE5E,oEAAoE;;IAEpE,8DAA8D;;aAE9D,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;IAEjC,6EAA6E;;;IAG7E,gDAAgD;;IAEhD,+DAA+D;;IAE/D,oEAAoE;;aAEpE,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAI3E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;aAKlC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAElF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB;;aAE3B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEpE,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;;aAE5B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEtE,iEAAiE;AACjE,eAAO,MAAM,cAAc;;;;aAIzB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;IAGpC,sDAAsD;;aAEtD,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/tasks.js

@@ -0,0 +1,146 @@
+import * as v from 'valibot';
+import { credentialFieldSchema } from './documents.js';
+// ---------------------------------------------------------------------------
+// Task-source integration wire contracts. A workspace can connect to one or
+// more external task/issue trackers (Jira, …), import individual issues
+// (projected locally as structured records), and attach an issue to a board
+// block as extra agent context.
+//
+// This is a sibling of the document-source integration, but task-shaped: an
+// issue is a first-class structured entity (status / type / assignee / priority
+// / labels + a Markdown description + comments), not a single page body. There
+// is deliberately no planner/spawn surface — issues are linked for context, not
+// expanded into board structure. Storage-only bookkeeping (the owning
+// workspace, the credential bag, the soft-delete tombstone) is NOT on the wire;
+// it lives in the core ports / D1 layer.
+// ---------------------------------------------------------------------------
+/** The external task trackers cat-factory can link to. */
+export const taskSourceKindSchema = v.picklist(['jira', 'github']);
+// ---- Provider self-description (drives the generic connect UI) ------------
+// `credentialFieldSchema` is shared with the document-source contracts: a
+// credential form field is identical regardless of what it connects to.
+/**
+ * Everything the frontend needs to render a source's connect form and import
+ * box without hard-coding any provider specifics.
+ */
+export const taskSourceDescriptorSchema = v.object({
+    source: taskSourceKindSchema,
+    /** Display name, e.g. `Jira`. */
+    label: v.string(),
+    /** Lucide icon name for the source. */
+    icon: v.string(),
+    /** Credentials required to connect, in display order. */
+    credentialFields: v.array(credentialFieldSchema),
+    /** Label for the "import an issue" input. */
+    refLabel: v.string(),
+    /** Placeholder for the "import an issue" input. */
+    refPlaceholder: v.string(),
+    /**
+     * Whether this source supports searching its catalogue by title/content (so
+     * the UI offers a search box, not just a paste-a-URL field). Optional for
+     * backward-compatibility; absent is treated as `false`.
+     */
+    searchable: v.optional(v.boolean()),
+});
+// ---- Connection + task projections ----------------------------------------
+/** A workspace's connection to a task source, as exposed to clients (never the credentials). */
+export const taskConnectionSchema = v.object({
+    source: taskSourceKindSchema,
+    /** A human-friendly label for what we're connected to (site URL). */
+    label: v.string(),
+    /** When the connection was established (epoch ms). */
+    connectedAt: v.number(),
+});
+/** A single comment on an issue, with its body normalized to Markdown. */
+export const taskCommentSchema = v.object({
+    /** Comment author's display name; '' when unknown. */
+    author: v.string(),
+    /** Source-supplied creation timestamp, kept as the source's ISO string. */
+    createdAt: v.string(),
+    /** Comment body, normalized to lightweight Markdown. */
+    body: v.string(),
+});
+/** An issue imported from a source, projected locally as a structured record. */
+export const sourceTaskSchema = v.object({
+    source: taskSourceKindSchema,
+    /** The source's canonical key for the issue (e.g. a Jira issue key `PROJ-123`). */
+    externalId: v.string(),
+    /** Issue summary / title. */
+    title: v.string(),
+    /** Canonical URL of the issue on the source. */
+    url: v.string(),
+    /** Workflow status name, e.g. `In Progress`. */
+    status: v.string(),
+    /** Issue type name, e.g. `Bug`. */
+    type: v.string(),
+    /** Assignee display name, or null when unassigned. */
+    assignee: v.nullable(v.string()),
+    /** Priority name, or null when none. */
+    priority: v.nullable(v.string()),
+    /** Issue labels. */
+    labels: v.array(v.string()),
+    /** Issue description, normalized to lightweight Markdown. */
+    description: v.string(),
+    /** Recent comments, oldest→newest, bodies normalized to Markdown. */
+    comments: v.array(taskCommentSchema),
+    /** A short plain-text excerpt of the issue (for list/preview rendering). */
+    excerpt: v.string(),
+    /** The board block this issue is attached to as context, if any. */
+    linkedBlockId: v.nullable(v.string()),
+    /** When this projection row was last refreshed (epoch ms). */
+    syncedAt: v.number(),
+});
+/**
+ * A single hit from searching a tracker. A lean shape (no description/comments)
+ * used to populate a picker: selecting one imports it (by `externalId`) and
+ * links it to a block. Distinct from {@link SourceTask} — a hit is not yet
+ * projected locally, so it carries no `linkedBlockId`/`syncedAt`.
+ */
+export const taskSearchResultSchema = v.object({
+    source: taskSourceKindSchema,
+    /** The source's canonical key for the issue (re-usable as an import ref). */
+    externalId: v.string(),
+    title: v.string(),
+    /** Canonical URL of the issue on the source. */
+    url: v.string(),
+    /** Workflow status name, e.g. `In Progress` (may be empty). */
+    status: v.string(),
+    /** A short plain-text excerpt for the result row (may be empty). */
+    excerpt: v.string(),
+});
+// ---- Request bodies -------------------------------------------------------
+/**
+ * Connect a workspace to a task source. The `credentials` bag is validated by
+ * the target provider (the `:source` is in the path), keeping the wire shape
+ * uniform across providers.
+ */
+export const connectTaskSourceSchema = v.object({
+    credentials: v.record(v.string(), v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(2000))),
+});
+/** Import (fetch + persist) an issue by its key or a full issue URL. */
+export const importTaskSchema = v.object({
+    ref: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(500)),
+});
+/** Search a tracker's issues by free text (title/content). */
+export const searchTasksSchema = v.object({
+    query: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(200)),
+});
+/** Attach an imported issue to a task as extra agent context. */
+export const linkTaskSchema = v.object({
+    source: taskSourceKindSchema,
+    externalId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    blockId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+/**
+ * Materialise an imported issue as a new board task (a leaf block) inside a
+ * container (service frame or module), and link the issue to it for context. The
+ * issue must already be imported (its key is `externalId`). The new task's
+ * title/description are seeded from the issue.
+ */
+export const createTaskFromIssueSchema = v.object({
+    source: taskSourceKindSchema,
+    externalId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    /** The frame or module the new task is created in. */
+    containerId: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+//# sourceMappingURL=tasks.js.map

package/dist/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../src/tasks.ts"],"names":[],"mappings":"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"}

package/dist/testing.d.ts

@@ -0,0 +1,67 @@
+import * as v from 'valibot';
+/** How serious a concern the Tester surfaced is. */
+export declare const testConcernSeveritySchema: v.PicklistSchema<["low", "medium", "high", "critical"], undefined>;
+export type TestConcernSeverity = v.InferOutput<typeof testConcernSeveritySchema>;
+/** A bug or risk the Tester uncovered, to be addressed by the `fixer` before re-test. */
+export declare const testConcernSchema: v.ObjectSchema<{
+    /** Short subject of the concern. */
+    readonly title: v.StringSchema<undefined>;
+    /** What's wrong / what was observed, concretely. */
+    readonly detail: v.StringSchema<undefined>;
+    /** Severity, so the fixer (and a human) can triage. */
+    readonly severity: v.PicklistSchema<["low", "medium", "high", "critical"], undefined>;
+}, undefined>;
+export type TestConcern = v.InferOutput<typeof testConcernSchema>;
+/** The result of exercising one tested area / requirement. */
+export declare const testOutcomeSchema: v.ObjectSchema<{
+    /** What was exercised (a requirement, scenario or area). */
+    readonly name: v.StringSchema<undefined>;
+    /** Whether it passed, failed, or could not be run. */
+    readonly status: v.PicklistSchema<["passed", "failed", "skipped"], undefined>;
+    /** Optional detail (the failure message, why it was skipped, etc.). */
+    readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type TestOutcome = v.InferOutput<typeof testOutcomeSchema>;
+/**
+ * A Tester's structured report. `greenlight` is the gate's verdict: true means the
+ * change is safe to release (no blocking concerns); false routes the run through
+ * the `fixer`. `tested` lists what the Tester decided to cover (this task's
+ * requirements plus best-judgement regression of related ones); `outcomes` are the
+ * per-area results; `concerns` are the bugs/risks to fix before re-testing.
+ */
+export declare const testReportSchema: v.ObjectSchema<{
+    /** The gate verdict: release-ready (true) or needs fixing (false). */
+    readonly greenlight: v.BooleanSchema<undefined>;
+    /** Plain-prose overall summary of the testing session. */
+    readonly summary: v.StringSchema<undefined>;
+    /** What the Tester chose to exercise (requirements + regression areas). */
+    readonly tested: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /** Per-area results. */
+    readonly outcomes: v.ArraySchema<v.ObjectSchema<{
+        /** What was exercised (a requirement, scenario or area). */
+        readonly name: v.StringSchema<undefined>;
+        /** Whether it passed, failed, or could not be run. */
+        readonly status: v.PicklistSchema<["passed", "failed", "skipped"], undefined>;
+        /** Optional detail (the failure message, why it was skipped, etc.). */
+        readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    /**
+     * Bugs/risks uncovered. A `high`/`critical` (blocking) concern implies
+     * `greenlight` must be false; `low`/`medium` concerns are advisory and do not, on
+     * their own, withhold the greenlight. The engine re-applies this rule defensively.
+     */
+    readonly concerns: v.ArraySchema<v.ObjectSchema<{
+        /** Short subject of the concern. */
+        readonly title: v.StringSchema<undefined>;
+        /** What's wrong / what was observed, concretely. */
+        readonly detail: v.StringSchema<undefined>;
+        /** Severity, so the fixer (and a human) can triage. */
+        readonly severity: v.PicklistSchema<["low", "medium", "high", "critical"], undefined>;
+    }, undefined>, undefined>;
+    /** Which environment the suite ran in, echoed back for the UI. */
+    readonly environment: v.OptionalSchema<v.PicklistSchema<["local", "ephemeral"], undefined>, undefined>;
+}, undefined>;
+export type TestReport = v.InferOutput<typeof testReportSchema>;
+/** Parse-or-throw a test report payload an agent returned (the engine validates it). */
+export declare function parseTestReport(value: unknown): TestReport;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAgB5B,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,oEAAoD,CAAA;AAC1F,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAEjF,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;IAC5B,oCAAoC;;IAEpC,oDAAoD;;IAEpD,uDAAuD;;aAEvD,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB;IAC5B,4DAA4D;;IAE5D,sDAAsD;;IAEtD,uEAAuE;;aAEvE,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;IAC3B,sEAAsE;;IAEtE,0DAA0D;;IAE1D,2EAA2E;;IAE3E,wBAAwB;;QAvBxB,4DAA4D;;QAE5D,sDAAsD;;QAEtD,uEAAuE;;;IAqBvE;;;;OAIG;;QAxCH,oCAAoC;;QAEpC,oDAAoD;;QAEpD,uDAAuD;;;IAsCvD,kEAAkE;;aAElE,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAE1D"}

package/dist/testing.js

@@ -0,0 +1,64 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Tester / Fixer wire contracts.
+//
+// The `tester` agent runs the project's tests — either against a provisioned
+// ephemeral environment or with its dependencies stood up locally (the Tester's
+// contributed `tester.environment` config picks which) — and returns a structured
+// report of what it exercised and what it found. If the report withholds its
+// greenlight (concerns/bugs surfaced), the engine dispatches the dedicated
+// `fixer` agent, hands it the report, and re-runs the Tester against the fixed
+// branch — looping until the Tester greenlights or the attempt budget is spent.
+// This mirrors the CI → ci-fixer gate, but the gate's signal is the Tester's own
+// structured report rather than GitHub check runs.
+// ---------------------------------------------------------------------------
+/** How serious a concern the Tester surfaced is. */
+export const testConcernSeveritySchema = v.picklist(['low', 'medium', 'high', 'critical']);
+/** A bug or risk the Tester uncovered, to be addressed by the `fixer` before re-test. */
+export const testConcernSchema = v.object({
+    /** Short subject of the concern. */
+    title: v.string(),
+    /** What's wrong / what was observed, concretely. */
+    detail: v.string(),
+    /** Severity, so the fixer (and a human) can triage. */
+    severity: testConcernSeveritySchema,
+});
+/** The result of exercising one tested area / requirement. */
+export const testOutcomeSchema = v.object({
+    /** What was exercised (a requirement, scenario or area). */
+    name: v.string(),
+    /** Whether it passed, failed, or could not be run. */
+    status: v.picklist(['passed', 'failed', 'skipped']),
+    /** Optional detail (the failure message, why it was skipped, etc.). */
+    detail: v.optional(v.string()),
+});
+/**
+ * A Tester's structured report. `greenlight` is the gate's verdict: true means the
+ * change is safe to release (no blocking concerns); false routes the run through
+ * the `fixer`. `tested` lists what the Tester decided to cover (this task's
+ * requirements plus best-judgement regression of related ones); `outcomes` are the
+ * per-area results; `concerns` are the bugs/risks to fix before re-testing.
+ */
+export const testReportSchema = v.object({
+    /** The gate verdict: release-ready (true) or needs fixing (false). */
+    greenlight: v.boolean(),
+    /** Plain-prose overall summary of the testing session. */
+    summary: v.string(),
+    /** What the Tester chose to exercise (requirements + regression areas). */
+    tested: v.array(v.string()),
+    /** Per-area results. */
+    outcomes: v.array(testOutcomeSchema),
+    /**
+     * Bugs/risks uncovered. A `high`/`critical` (blocking) concern implies
+     * `greenlight` must be false; `low`/`medium` concerns are advisory and do not, on
+     * their own, withhold the greenlight. The engine re-applies this rule defensively.
+     */
+    concerns: v.array(testConcernSchema),
+    /** Which environment the suite ran in, echoed back for the UI. */
+    environment: v.optional(v.picklist(['local', 'ephemeral'])),
+});
+/** Parse-or-throw a test report payload an agent returned (the engine validates it). */
+export function parseTestReport(value) {
+    return v.parse(testReportSchema, value);
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,iCAAiC;AACjC,EAAE;AACF,6EAA6E;AAC7E,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,2EAA2E;AAC3E,+EAA+E;AAC/E,gFAAgF;AAChF,iFAAiF;AACjF,mDAAmD;AACnD,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;AAG1F,yFAAyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,oCAAoC;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,oDAAoD;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,uDAAuD;IACvD,QAAQ,EAAE,yBAAyB;CACpC,CAAC,CAAA;AAGF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,4DAA4D;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,sDAAsD;IACtD,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnD,uEAAuE;IACvE,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC/B,CAAC,CAAA;AAGF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,sEAAsE;IACtE,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,0DAA0D;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,2EAA2E;IAC3E,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACpC;;;;OAIG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACpC,kEAAkE;IAClE,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;CAC5D,CAAC,CAAA;AAGF,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;AACzC,CAAC"}

package/dist/tracker.d.ts

@@ -0,0 +1,18 @@
+import * as v from 'valibot';
+export declare const trackerKindSchema: v.PicklistSchema<["github", "jira"], undefined>;
+export type TrackerKind = v.InferOutput<typeof trackerKindSchema>;
+/** A workspace's issue-tracker selection. `tracker: null` means none configured. */
+export declare const trackerSettingsSchema: v.ObjectSchema<{
+    readonly tracker: v.NullableSchema<v.PicklistSchema<["github", "jira"], undefined>, undefined>;
+    /** Jira project key new tickets are filed under (e.g. "ENG"); null unless Jira. */
+    readonly jiraProjectKey: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly updatedAt: v.NumberSchema<undefined>;
+}, undefined>;
+export type TrackerSettings = v.InferOutput<typeof trackerSettingsSchema>;
+/** Set a workspace's issue-tracker selection. */
+export declare const putTrackerSettingsSchema: v.ObjectSchema<{
+    readonly tracker: v.NullableSchema<v.PicklistSchema<["github", "jira"], undefined>, undefined>;
+    readonly jiraProjectKey: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction]>, undefined>, undefined>;
+}, undefined>;
+export type PutTrackerSettingsInput = v.InferOutput<typeof putTrackerSettingsSchema>;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B,eAAO,MAAM,iBAAiB,iDAAiC,CAAA;AAC/D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,oFAAoF;AACpF,eAAO,MAAM,qBAAqB;;IAEhC,mFAAmF;;;aAGnF,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,iDAAiD;AACjD,eAAO,MAAM,wBAAwB;;;aAGnC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/tracker.js

@@ -0,0 +1,24 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Issue-tracker wire contracts. A workspace can designate ONE issue tracker —
+// GitHub Issues or Jira — where automated flows (notably the tech-debt recurring
+// pipeline's `tracker` step) file the ticket they raise before implementation
+// starts. The choice is workspace-level config; the credentials it uses come from
+// the existing GitHub App installation (for GitHub) or the workspace's Jira
+// `task_connections` row (for Jira), so only the selection + Jira project key live
+// here.
+// ---------------------------------------------------------------------------
+export const trackerKindSchema = v.picklist(['github', 'jira']);
+/** A workspace's issue-tracker selection. `tracker: null` means none configured. */
+export const trackerSettingsSchema = v.object({
+    tracker: v.nullable(trackerKindSchema),
+    /** Jira project key new tickets are filed under (e.g. "ENG"); null unless Jira. */
+    jiraProjectKey: v.nullable(v.string()),
+    updatedAt: v.number(),
+});
+/** Set a workspace's issue-tracker selection. */
+export const putTrackerSettingsSchema = v.object({
+    tracker: v.nullable(trackerKindSchema),
+    jiraProjectKey: v.optional(v.nullable(v.pipe(v.string(), v.trim()))),
+});
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,kFAAkF;AAClF,4EAA4E;AAC5E,mFAAmF;AACnF,QAAQ;AACR,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;AAG/D,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACtC,mFAAmF;IACnF,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAA;AAGF,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACtC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;CACrE,CAAC,CAAA"}

package/dist/vendor-credentials.d.ts

@@ -0,0 +1,37 @@
+import * as v from 'valibot';
+/** Vendors whose subscription harnesses we support. */
+export declare const subscriptionVendorSchema: v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>;
+export type SubscriptionVendor = v.InferOutput<typeof subscriptionVendorSchema>;
+/** One pool token as exposed to clients — metadata + usage, never the secret. */
+export declare const vendorCredentialSchema: v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly vendor: v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>;
+    readonly label: v.StringSchema<undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly lastUsedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** Rolling-window usage so the UI can show load and rotation fairness. */
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+    readonly requestCount: v.NumberSchema<undefined>;
+}, undefined>;
+export type VendorCredential = v.InferOutput<typeof vendorCredentialSchema>;
+export declare const vendorCredentialListSchema: v.ArraySchema<v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly vendor: v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>;
+    readonly label: v.StringSchema<undefined>;
+    readonly createdAt: v.NumberSchema<undefined>;
+    readonly lastUsedAt: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    /** Rolling-window usage so the UI can show load and rotation fairness. */
+    readonly inputTokens: v.NumberSchema<undefined>;
+    readonly outputTokens: v.NumberSchema<undefined>;
+    readonly requestCount: v.NumberSchema<undefined>;
+}, undefined>, undefined>;
+export type VendorCredentialList = v.InferOutput<typeof vendorCredentialListSchema>;
+/** Add a token to the pool. `token` is write-only (the raw secret blob). */
+export declare const addVendorCredentialSchema: v.ObjectSchema<{
+    readonly vendor: v.PicklistSchema<["claude", "codex", "glm", "kimi", "deepseek"], undefined>;
+    readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly token: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type AddVendorCredentialInput = v.InferOutput<typeof addVendorCredentialSchema>;
+//# sourceMappingURL=vendor-credentials.d.ts.map

package/dist/vendor-credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-credentials.d.ts","sourceRoot":"","sources":["../src/vendor-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAoB5B,uDAAuD;AACvD,eAAO,MAAM,wBAAwB,6EAA6D,CAAA;AAClG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E,iFAAiF;AACjF,eAAO,MAAM,sBAAsB;;;;;;IAMjC,0EAA0E;;;;aAI1E,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,eAAO,MAAM,0BAA0B;;;;;;IAPrC,0EAA0E;;;;yBAOH,CAAA;AACzE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB;;;;aAIpC,CAAA;AACF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/vendor-credentials.js

@@ -0,0 +1,40 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Provider-subscription (vendor) credential wire contracts.
+//
+// A workspace connects one or more subscription credentials per vendor so the
+// Claude Code / Codex harnesses can authenticate inside a per-run container
+// without an API key:
+//   - `claude`: a long-lived OAuth token from `claude setup-token`
+//     (injected as CLAUDE_CODE_OAUTH_TOKEN, talks to api.anthropic.com).
+//   - `glm` / `kimi` / `deepseek`: a coding-plan API key for a vendor that exposes
+//     an Anthropic-compatible endpoint (Z.ai / Moonshot / DeepSeek), driven by
+//     Claude Code via ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN.
+//   - `codex`: the full ChatGPT `auth.json` bundle (written to $CODEX_HOME).
+//
+// Tokens form a pool, leased with usage-aware rotation. The raw secret is
+// write-only — it is encrypted at rest and never returned; only metadata +
+// rolling-window usage counters are exposed back to clients.
+// ---------------------------------------------------------------------------
+/** Vendors whose subscription harnesses we support. */
+export const subscriptionVendorSchema = v.picklist(['claude', 'codex', 'glm', 'kimi', 'deepseek']);
+/** One pool token as exposed to clients — metadata + usage, never the secret. */
+export const vendorCredentialSchema = v.object({
+    id: v.string(),
+    vendor: subscriptionVendorSchema,
+    label: v.string(),
+    createdAt: v.number(),
+    lastUsedAt: v.nullable(v.number()),
+    /** Rolling-window usage so the UI can show load and rotation fairness. */
+    inputTokens: v.number(),
+    outputTokens: v.number(),
+    requestCount: v.number(),
+});
+export const vendorCredentialListSchema = v.array(vendorCredentialSchema);
+/** Add a token to the pool. `token` is write-only (the raw secret blob). */
+export const addVendorCredentialSchema = v.object({
+    vendor: subscriptionVendorSchema,
+    label: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(120)),
+    token: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+//# sourceMappingURL=vendor-credentials.js.map

package/dist/vendor-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-credentials.js","sourceRoot":"","sources":["../src/vendor-credentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,4DAA4D;AAC5D,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,sBAAsB;AACtB,mEAAmE;AACnE,yEAAyE;AACzE,mFAAmF;AACnF,+EAA+E;AAC/E,iEAAiE;AACjE,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,6DAA6D;AAC7D,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAA;AAGlG,iFAAiF;AACjF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,wBAAwB;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,0EAA0E;IAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;AAGzE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,wBAAwB;IAChC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CACpD,CAAC,CAAA"}

package/dist/workspace-settings.d.ts

@@ -0,0 +1,36 @@
+import * as v from 'valibot';
+/**
+ * How the per-service running-task limit is bucketed:
+ *  - `off`      — no limit (the default).
+ *  - `shared`   — one shared cap across all task types under a service.
+ *  - `per_type` — a separate cap per task type under a service.
+ */
+export declare const taskLimitModeSchema: v.PicklistSchema<["off", "shared", "per_type"], undefined>;
+export type TaskLimitMode = v.InferOutput<typeof taskLimitModeSchema>;
+/** Per-task-type running-task caps (used when {@link taskLimitModeSchema} is `per_type`). */
+export declare const taskLimitPerTypeSchema: v.RecordSchema<v.PicklistSchema<["feature", "bug", "document", "spike"], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+export type TaskLimitPerType = v.InferOutput<typeof taskLimitPerTypeSchema>;
+/** A workspace's runtime settings. */
+export declare const workspaceSettingsSchema: v.ObjectSchema<{
+    /**
+     * Minutes a run may wait for human input before its open notification escalates
+     * from `normal` (yellow) to `urgent` (red). The run itself is never auto-failed.
+     */
+    readonly waitingEscalationMinutes: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100000, undefined>]>;
+    /** Whether/how the per-service running-task limit is enforced. */
+    readonly taskLimitMode: v.PicklistSchema<["off", "shared", "per_type"], undefined>;
+    /** The shared cap, when {@link taskLimitMode} is `shared`. Null otherwise. */
+    readonly taskLimitShared: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+    /** The per-type caps, when {@link taskLimitMode} is `per_type`. Null otherwise. */
+    readonly taskLimitPerType: v.NullableSchema<v.RecordSchema<v.PicklistSchema<["feature", "bug", "document", "spike"], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>, undefined>;
+}, undefined>;
+export type WorkspaceSettings = v.InferOutput<typeof workspaceSettingsSchema>;
+/** Update a workspace's runtime settings (full replace of the supplied fields). */
+export declare const updateWorkspaceSettingsSchema: v.ObjectSchema<{
+    readonly waitingEscalationMinutes: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 100000, undefined>]>, undefined>;
+    readonly taskLimitMode: v.OptionalSchema<v.PicklistSchema<["off", "shared", "per_type"], undefined>, undefined>;
+    readonly taskLimitShared: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>, undefined>;
+    readonly taskLimitPerType: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.PicklistSchema<["feature", "bug", "document", "spike"], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>, undefined>, undefined>;
+}, undefined>;
+export type UpdateWorkspaceSettingsInput = v.InferOutput<typeof updateWorkspaceSettingsSchema>;
+//# sourceMappingURL=workspace-settings.d.ts.map

package/dist/workspace-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-settings.d.ts","sourceRoot":"","sources":["../src/workspace-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAW5B;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,4DAA4C,CAAA;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAIrE,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,gRAA8C,CAAA;AACjF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,sCAAsC;AACtC,eAAO,MAAM,uBAAuB;IAClC;;;OAGG;;IAEH,kEAAkE;;IAElE,8EAA8E;;IAE9E,mFAAmF;;aAEnF,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;aAOxC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA"}

package/dist/workspace-settings.js

@@ -0,0 +1,41 @@
+import * as v from 'valibot';
+import { createTaskTypeSchema } from './primitives.js';
+// ---------------------------------------------------------------------------
+// Per-workspace runtime settings. A single settings object per workspace (lazily
+// seeded from the defaults) holding the operator-tunable policies that aren't
+// per-task: how long a run may wait for a human before its notification escalates
+// to red, and whether/how to cap the number of tasks running concurrently under one
+// service. Persisted in the `workspace_settings` table on both runtime facades.
+// ---------------------------------------------------------------------------
+/**
+ * How the per-service running-task limit is bucketed:
+ *  - `off`      — no limit (the default).
+ *  - `shared`   — one shared cap across all task types under a service.
+ *  - `per_type` — a separate cap per task type under a service.
+ */
+export const taskLimitModeSchema = v.picklist(['off', 'shared', 'per_type']);
+const limitSchema = v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(1000));
+/** Per-task-type running-task caps (used when {@link taskLimitModeSchema} is `per_type`). */
+export const taskLimitPerTypeSchema = v.record(createTaskTypeSchema, limitSchema);
+/** A workspace's runtime settings. */
+export const workspaceSettingsSchema = v.object({
+    /**
+     * Minutes a run may wait for human input before its open notification escalates
+     * from `normal` (yellow) to `urgent` (red). The run itself is never auto-failed.
+     */
+    waitingEscalationMinutes: v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100_000)),
+    /** Whether/how the per-service running-task limit is enforced. */
+    taskLimitMode: taskLimitModeSchema,
+    /** The shared cap, when {@link taskLimitMode} is `shared`. Null otherwise. */
+    taskLimitShared: v.nullable(limitSchema),
+    /** The per-type caps, when {@link taskLimitMode} is `per_type`. Null otherwise. */
+    taskLimitPerType: v.nullable(taskLimitPerTypeSchema),
+});
+/** Update a workspace's runtime settings (full replace of the supplied fields). */
+export const updateWorkspaceSettingsSchema = v.object({
+    waitingEscalationMinutes: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(100_000))),
+    taskLimitMode: v.optional(taskLimitModeSchema),
+    taskLimitShared: v.optional(v.nullable(limitSchema)),
+    taskLimitPerType: v.optional(v.nullable(taskLimitPerTypeSchema)),
+});
+//# sourceMappingURL=workspace-settings.js.map

package/dist/workspace-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-settings.js","sourceRoot":"","sources":["../src/workspace-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtD,8EAA8E;AAC9E,iFAAiF;AACjF,8EAA8E;AAC9E,kFAAkF;AAClF,oFAAoF;AACpF,gFAAgF;AAChF,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAA;AAG5E,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;AAEpF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAA;AAGjF,sCAAsC;AACtC,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C;;;OAGG;IACH,wBAAwB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7F,kEAAkE;IAClE,aAAa,EAAE,mBAAmB;IAClC,8EAA8E;IAC9E,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;IACxC,mFAAmF;IACnF,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACrD,CAAC,CAAA;AAGF,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,wBAAwB,EAAE,CAAC,CAAC,QAAQ,CAClC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CACpE;IACD,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC9C,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACpD,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;CACjE,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@cat-factory/contracts",
+  "version": "0.6.0",
+  "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "valibot": "^1.4.1"
+  },
+  "devDependencies": {
+    "typescript": "7.0.1-rc"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}