@cat-factory/contracts 0.154.2 → 0.156.0

package/dist/task-types.js

@@ -0,0 +1,82 @@
+import * as v from 'valibot';
+import { namespacedIdSchema } from './primitives.js';
+// ---------------------------------------------------------------------------
+// The wire projection of a CUSTOM (deployment-registered) task type — the frontend analogue
+// of `customAgentKindSchema` (`agent-presentation.ts`). A deployment registers a task type on
+// its app-owned `TaskTypeRegistry`; the server serialises each registration's presentation +
+// create-form fields into the workspace snapshot (`customTaskTypes`), and the SPA merges them
+// into one task-type catalog so a proprietary work item (an "incident", "pentest",
+// "compliance-audit") becomes a first-class create-task choice + card badge instead of the
+// generic fallback — symmetric with agent kinds.
+//
+// The task type id itself widens `taskTypeSchema` (`primitives.ts`) from a closed picklist to
+// `picklist ∪ namespaced`, exactly the shape `presentation.resultView` uses. An UNREGISTERED
+// namespaced type (stale data after an extension was removed) degrades to the `feature`
+// presentation on the frontend, so a leftover string never breaks a card.
+// ---------------------------------------------------------------------------
+/** Card-badge + create-form presentation for a custom task type (mirrors `agentPresentationSchema`). */
+export const taskTypePresentationSchema = v.object({
+    /** Human label, e.g. `Incident`. */
+    label: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(80)),
+    /** Icon id (e.g. an `i-lucide-*` name). */
+    icon: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    /** Accent colour (CSS hex/keyword). */
+    color: v.pipe(v.string(), v.minLength(1), v.maxLength(40)),
+    /** One-line description shown in the create-task type picker. */
+    description: v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(500)),
+});
+/** One choice of a `select` {@link taskTypeFieldDescriptorSchema}. */
+export const taskTypeFieldOptionSchema = v.object({
+    value: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    label: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+});
+/**
+ * One data-driven field on a custom task type's create-form — the descriptor-driven form
+ * vocabulary (the `credentialFieldSchema` / `agentConfigDescriptorSchema` shape generalized):
+ * a label + input kind + options. Its value lands in the sparse `taskTypeFields.custom` bag
+ * keyed by {@link key}, so adding a field never needs a schema migration.
+ */
+export const taskTypeFieldDescriptorSchema = v.object({
+    /** Stable key the collected value is stored under in `taskTypeFields.custom`. */
+    key: v.pipe(v.string(), v.minLength(1), v.maxLength(80)),
+    /** Human label shown next to the field. */
+    label: v.pipe(v.string(), v.minLength(1), v.maxLength(120)),
+    /** The control type: free text, multi-line text, a number, or one of {@link options}. */
+    type: v.picklist(['text', 'textarea', 'number', 'select']),
+    /** One-line helper text shown under the field. */
+    help: v.optional(v.pipe(v.string(), v.maxLength(300))),
+    /** Placeholder shown in an empty `text`/`textarea`/`number` input. */
+    placeholder: v.optional(v.pipe(v.string(), v.maxLength(200))),
+    /** The choices for a `select` descriptor; absent (and ignored) for the other types. */
+    options: v.optional(v.array(taskTypeFieldOptionSchema)),
+    /** Whether the field must be filled before the task can be created. */
+    required: v.optional(v.boolean()),
+    /** Max length for a `text`/`textarea` value (characters). */
+    maxLength: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(10000))),
+});
+/**
+ * A registered custom task type's wire projection — the snapshot entry the SPA merges into its
+ * task-type catalog. Its `taskType` is ALWAYS namespaced ({@link namespacedIdSchema}); a
+ * built-in type is never delivered this way.
+ */
+export const customTaskTypeSchema = v.object({
+    /** The namespaced task type id (`<ns>:<name>`, e.g. `acme:incident`). */
+    taskType: namespacedIdSchema,
+    /** Card badge + create-form presentation. */
+    presentation: taskTypePresentationSchema,
+    /** Data-driven create-form fields (optional; none ⇒ title + description only). */
+    fields: v.optional(v.array(taskTypeFieldDescriptorSchema)),
+    /**
+     * The pipeline a task of this type defaults to when the creator pins none — pairs with a
+     * pipeline the deployment also registered (validated at boot). Absent ⇒ the workspace's
+     * positional default, exactly like an unmapped built-in type.
+     */
+    defaultPipelineId: v.optional(v.string()),
+    /**
+     * Optional id of a bespoke create-form section component (`<ns>:<name>`) the deployment
+     * contributes to the frontend `taskTypeFormPanels` slot, shown INSTEAD of the descriptor
+     * `fields` above. Unpaired ⇒ the descriptor fields render (degrade, never crash).
+     */
+    formPanel: v.optional(namespacedIdSchema),
+});
+//# sourceMappingURL=task-types.js.map

package/dist/task-types.js.map

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

package/dist/workspace-settings.d.ts

@@ -8,7 +8,7 @@ import * as v from 'valibot';
 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", "review", "ralph"], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+export declare const taskLimitPerTypeSchema: v.RecordSchema<v.UnionSchema<[v.PicklistSchema<readonly ["feature", "bug", "document", "spike", "review", "ralph"], undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Consumer id must be <namespace>:<name> (lowercase a-z0-9, dash-separated)">]>], 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<{
@@ -22,7 +22,7 @@ export declare const workspaceSettingsSchema: v.ObjectSchema<{
     /** 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", "review", "ralph"], undefined>, 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.NullableSchema<v.RecordSchema<v.UnionSchema<[v.PicklistSchema<readonly ["feature", "bug", "document", "spike", "review", "ralph"], undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Consumer id must be <namespace>:<name> (lowercase a-z0-9, dash-separated)">]>], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>, undefined>;
     /**
      * Whether to store the complete context provided to each container agent (the
      * fully composed system + user prompts, the best-practice fragment bodies folded
@@ -73,7 +73,7 @@ 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", "review", "ralph"], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>, undefined>, undefined>;
+    readonly taskLimitPerType: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.UnionSchema<[v.PicklistSchema<readonly ["feature", "bug", "document", "spike", "review", "ralph"], undefined>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "Consumer id must be <namespace>:<name> (lowercase a-z0-9, dash-separated)">]>], undefined>, v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>, undefined>, undefined>;
     readonly storeAgentContext: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly artifactRetentionDays: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 3650, undefined>]>, undefined>;
     readonly kaizenEnabled: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;

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

@@ -1 +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,mSAA8C,CAAA;AACjF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAoB3E,sCAAsC;AACtC,eAAO,MAAM,uBAAuB;IAClC;;;OAGG;;IAEH,kEAAkE;;IAElE,8EAA8E;;IAE9E,mFAAmF;;IAEnF;;;;;;;OAOG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH,6EAA6E;;IAE7E;;;;;;;;;;OAUG;;aAEH,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;aAexC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA"}
+{"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,oeAA8C,CAAA;AACjF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAoB3E,sCAAsC;AACtC,eAAO,MAAM,uBAAuB;IAClC;;;OAGG;;IAEH,kEAAkE;;IAElE,8EAA8E;;IAE9E,mFAAmF;;IAEnF;;;;;;;OAOG;;IAEH;;;;OAIG;;IAEH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH,6EAA6E;;IAE7E;;;;;;;;;;OAUG;;aAEH,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;aAexC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/contracts",
-  "version": "0.154.2",
+  "version": "0.156.0",
   "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
   "repository": {
     "type": "git",