@cat-factory/contracts 0.6.0

package/dist/release.d.ts

@@ -0,0 +1,60 @@
+import * as v from 'valibot';
+/** One monitored signal (a Datadog monitor or SLO), flattened to its current state. */
+export declare const releaseSignalSchema: v.ObjectSchema<{
+    readonly kind: v.PicklistSchema<["monitor", "slo"], undefined>;
+    readonly id: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly state: v.PicklistSchema<["ok", "warn", "alert", "no_data"], undefined>;
+    readonly detail: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type ReleaseSignalWire = v.InferOutput<typeof releaseSignalSchema>;
+/** What the on-call agent recommends doing about the regression. */
+export declare const onCallRecommendationSchema: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+export type OnCallRecommendation = v.InferOutput<typeof onCallRecommendationSchema>;
+/**
+ * The `on-call` agent's structured assessment of a release regression. `culpritConfidence`
+ * (0..1) is how strongly the evidence points at THIS PR as the cause; `recommendation`
+ * is the suggested human action; `evidence` lists the concrete observations behind it.
+ */
+export declare const onCallAssessmentSchema: v.ObjectSchema<{
+    /** How confident the agent is that the released PR caused the regression (0..1). */
+    readonly culpritConfidence: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>;
+    /** The recommended human action. */
+    readonly recommendation: v.PicklistSchema<["revert", "hold", "monitor"], undefined>;
+    /** Plain-prose justification. */
+    readonly rationale: v.StringSchema<undefined>;
+    /** Concrete observations behind the verdict (log lines, correlations, diff hunks). */
+    readonly evidence: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, readonly []>;
+}, undefined>;
+export type OnCallAssessment = v.InferOutput<typeof onCallAssessmentSchema>;
+/** Parse-or-throw an on-call assessment payload the agent returned. */
+export declare function parseOnCallAssessment(value: unknown): OnCallAssessment;
+/** Set/replace the workspace's Datadog connection (keys write-only, never read back). */
+export declare const upsertDatadogConnectionSchema: v.ObjectSchema<{
+    readonly site: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly apiKey: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+    readonly appKey: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type UpsertDatadogConnectionInput = v.InferOutput<typeof upsertDatadogConnectionSchema>;
+/** What `GET /datadog/connection` returns — never the secret keys. */
+export declare const datadogConnectionViewSchema: v.ObjectSchema<{
+    readonly connected: v.BooleanSchema<undefined>;
+    readonly site: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type DatadogConnectionView = v.InferOutput<typeof datadogConnectionViewSchema>;
+/** A block's monitor/SLO mapping for the post-release-health gate. */
+export declare const releaseHealthConfigSchema: v.ObjectSchema<{
+    readonly blockId: v.StringSchema<undefined>;
+    readonly monitorIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    readonly sloIds: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    readonly envTag: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+export type ReleaseHealthConfigWire = v.InferOutput<typeof releaseHealthConfigSchema>;
+/** Create/replace a block's release-health config. */
+export declare const upsertReleaseHealthConfigSchema: v.ObjectSchema<{
+    readonly monitorIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>, readonly []>;
+    readonly sloIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>, readonly []>;
+    readonly envTag: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>, v.RegexAction<string, "envTag may only contain letters, digits and _.-/ (no spaces or query characters)">]>, undefined>, undefined>;
+}, undefined>;
+export type UpsertReleaseHealthConfigInput = v.InferOutput<typeof upsertReleaseHealthConfigSchema>;
+//# sourceMappingURL=release.d.ts.map

package/dist/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAY5B,uFAAuF;AACvF,eAAO,MAAM,mBAAmB;;;;;;aAM9B,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAEzE,oEAAoE;AACpE,eAAO,MAAM,0BAA0B,4DAA4C,CAAA;AACnF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAEnF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IACjC,oFAAoF;;IAEpF,oCAAoC;;IAEpC,iCAAiC;;IAEjC,sFAAsF;;aAEtF,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEtE;AAOD,yFAAyF;AACzF,eAAO,MAAM,6BAA6B;;;;aAIxC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAE9F,sEAAsE;AACtE,eAAO,MAAM,2BAA2B;;;aAGtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAIrF,sEAAsE;AACtE,eAAO,MAAM,yBAAyB;;;;;aAKpC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAmBrF,sDAAsD;AACtD,eAAO,MAAM,+BAA+B;;;;aAI1C,CAAA;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,+BAA+B,CAAC,CAAA"}

package/dist/release.js

@@ -0,0 +1,75 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Post-release-health wire contracts. After a release deploys, the
+// `post-release-health` gate watches the team's Datadog monitors/SLOs over a
+// monitoring window. On a regression it dispatches the `on-call` agent, which
+// reasons over an evidence bundle + the released PR diff and returns this
+// structured assessment (it makes NO commits and reverts nothing). The engine
+// then raises a `release_regression` notification carrying the assessment + the
+// regressed signals for a human to act on (revert / acknowledge).
+// ---------------------------------------------------------------------------
+/** One monitored signal (a Datadog monitor or SLO), flattened to its current state. */
+export const releaseSignalSchema = v.object({
+    kind: v.picklist(['monitor', 'slo']),
+    id: v.string(),
+    name: v.string(),
+    state: v.picklist(['ok', 'warn', 'alert', 'no_data']),
+    detail: v.optional(v.string()),
+});
+/** What the on-call agent recommends doing about the regression. */
+export const onCallRecommendationSchema = v.picklist(['revert', 'hold', 'monitor']);
+/**
+ * The `on-call` agent's structured assessment of a release regression. `culpritConfidence`
+ * (0..1) is how strongly the evidence points at THIS PR as the cause; `recommendation`
+ * is the suggested human action; `evidence` lists the concrete observations behind it.
+ */
+export const onCallAssessmentSchema = v.object({
+    /** How confident the agent is that the released PR caused the regression (0..1). */
+    culpritConfidence: v.pipe(v.number(), v.minValue(0), v.maxValue(1)),
+    /** The recommended human action. */
+    recommendation: onCallRecommendationSchema,
+    /** Plain-prose justification. */
+    rationale: v.string(),
+    /** Concrete observations behind the verdict (log lines, correlations, diff hunks). */
+    evidence: v.optional(v.array(v.string()), []),
+});
+/** Parse-or-throw an on-call assessment payload the agent returned. */
+export function parseOnCallAssessment(value) {
+    return v.parse(onCallAssessmentSchema, value);
+}
+// ---- Datadog connection (per-workspace) -----------------------------------
+/** Datadog site host the connection points at. */
+const datadogSiteSchema = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(120));
+/** Set/replace the workspace's Datadog connection (keys write-only, never read back). */
+export const upsertDatadogConnectionSchema = v.object({
+    site: datadogSiteSchema,
+    apiKey: v.pipe(v.string(), v.trim(), v.minLength(1)),
+    appKey: v.pipe(v.string(), v.trim(), v.minLength(1)),
+});
+/** What `GET /datadog/connection` returns — never the secret keys. */
+export const datadogConnectionViewSchema = v.object({
+    connected: v.boolean(),
+    site: v.nullable(v.string()),
+});
+// ---- Release-health config (per repo/service block) -----------------------
+/** A block's monitor/SLO mapping for the post-release-health gate. */
+export const releaseHealthConfigSchema = v.object({
+    blockId: v.string(),
+    monitorIds: v.array(v.string()),
+    sloIds: v.array(v.string()),
+    envTag: v.nullable(v.string()),
+});
+/**
+ * A Datadog env tag value. Constrained to the characters a real env/tag value uses so it
+ * can be interpolated into a Datadog log query (`status:error env:<tag>`) without spaces
+ * or query metacharacters (`* ( ) :` and whitespace) that would silently broaden or break
+ * the query — and silently empty the on-call evidence bundle.
+ */
+const envTagSchema = v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(120), v.regex(/^[A-Za-z0-9_.\-/]+$/, 'envTag may only contain letters, digits and _.-/ (no spaces or query characters)'));
+/** Create/replace a block's release-health config. */
+export const upsertReleaseHealthConfigSchema = v.object({
+    monitorIds: v.optional(v.array(v.pipe(v.string(), v.trim(), v.minLength(1))), []),
+    sloIds: v.optional(v.array(v.pipe(v.string(), v.trim(), v.minLength(1))), []),
+    envTag: v.optional(v.nullable(envTagSchema)),
+});
+//# sourceMappingURL=release.js.map

package/dist/release.js.map

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

package/dist/requests.d.ts

@@ -0,0 +1,451 @@
+import * as v from 'valibot';
+export declare const createWorkspaceSchema: v.ObjectSchema<{
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    /** Optional free-text description shown on the board switcher / onboarding list. */
+    readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 500, undefined>]>, undefined>;
+    /**
+     * Seed the board with the sample architecture *blocks* (default true; the SPA
+     * passes false so real boards start empty). The pipeline catalog is always
+     * provisioned regardless — it is product config, not sample data.
+     */
+    readonly seed: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /**
+     * The account the new board belongs to. Optional: when omitted (or in the
+     * auth-disabled path) the board is created in the caller's personal account, or
+     * unscoped when there is no signed-in user.
+     */
+    readonly accountId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+}, undefined>;
+export type CreateWorkspaceInput = v.InferOutput<typeof createWorkspaceSchema>;
+/** Rename a board and/or update its description. */
+export declare const renameWorkspaceSchema: v.ObjectSchema<{
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    /** `null` clears the description; an absent key leaves it unchanged. */
+    readonly description: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 500, undefined>]>, undefined>, undefined>;
+}, undefined>;
+export type RenameWorkspaceInput = v.InferOutput<typeof renameWorkspaceSchema>;
+export declare const addFrameSchema: v.ObjectSchema<{
+    readonly type: v.PicklistSchema<["frontend", "service", "api", "database", "queue", "integration", "external", "environment"], undefined>;
+    readonly position: v.ObjectSchema<{
+        readonly x: v.NumberSchema<undefined>;
+        readonly y: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>;
+export type AddFrameInput = v.InferOutput<typeof addFrameSchema>;
+/**
+ * Add a service frame backed by an EXISTING GitHub repo the App can access.
+ * Unlike bootstrap there is no container / agent run: the backend links + syncs
+ * the repo into the workspace (if it wasn't already tracked), creates the frame
+ * `ready`, and links the repo projection to it. `position` is optional — the
+ * backend lays the frame out when omitted (the side-panel button passes none).
+ */
+export declare const addServiceFromRepoSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly position: v.OptionalSchema<v.ObjectSchema<{
+        readonly x: v.NumberSchema<undefined>;
+        readonly y: v.NumberSchema<undefined>;
+    }, undefined>, undefined>;
+    /**
+     * For a monorepo repo, the subdirectory (relative to the repo root) this service
+     * lives in, e.g. `packages/api`. Omitted/empty for a whole-repo service. The
+     * frame is titled after the directory's base name when given.
+     */
+    readonly directory: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * Whether the backing repo is a monorepo (hosts several services). Sent as part of
+     * the add request instead of a separate up-front PATCH; when provided the backend
+     * persists the repo's monorepo flag, then requires a {@link directory}. A monorepo
+     * repo can back several service frames, each pinned to its own subdirectory.
+     */
+    readonly isMonorepo: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type AddServiceFromRepoInput = v.InferOutput<typeof addServiceFromRepoSchema>;
+export declare const addTaskSchema: v.ObjectSchema<{
+    readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 200, undefined>]>;
+    readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+    readonly taskType: v.OptionalSchema<v.PicklistSchema<["feature", "bug", "document", "spike"], undefined>, undefined>;
+    readonly taskTypeFields: v.OptionalSchema<v.ObjectSchema<{
+        readonly severity: v.OptionalSchema<v.PicklistSchema<["low", "medium", "high", "critical"], undefined>, undefined>;
+        readonly stepsToReproduce: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 4000, undefined>]>, undefined>;
+        readonly timeboxHours: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1000, undefined>]>, undefined>;
+        readonly docKind: v.OptionalSchema<v.PicklistSchema<["prd", "rfc", "runbook", "reference", "other"], undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly mergePresetId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    readonly pipelineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+}, undefined>;
+export type AddTaskInput = v.InferOutput<typeof addTaskSchema>;
+export declare const addModuleSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly position: v.OptionalSchema<v.ObjectSchema<{
+        readonly x: v.NumberSchema<undefined>;
+        readonly y: v.NumberSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type AddModuleInput = v.InferOutput<typeof addModuleSchema>;
+export declare const updateBlockSchema: Omit<v.ObjectSchema<{
+    readonly title: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>;
+    readonly description: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>;
+    readonly position: v.ObjectSchema<{
+        readonly x: v.NumberSchema<undefined>;
+        readonly y: v.NumberSchema<undefined>;
+    }, undefined>;
+    readonly size: v.ObjectSchema<{
+        readonly w: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>]>;
+        readonly h: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>]>;
+    }, undefined>;
+    readonly moduleName: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly fragmentIds: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    readonly serviceFragmentIds: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    readonly modelId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly mergePresetId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly pipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly agentConfig: v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+    readonly testComposePath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>;
+    readonly noInfraDependencies: v.BooleanSchema<undefined>;
+    readonly cloudProvider: v.PicklistSchema<["cloudflare", "docker", "aws", "gcp", "azure", "custom"], undefined>;
+    readonly instanceSize: v.PicklistSchema<["small", "medium", "large", "xlarge"], undefined>;
+}, undefined>, "entries" | "~run" | "~standard" | "~types"> & {
+    readonly entries: {
+        readonly title: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+        readonly description: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly position: v.OptionalSchema<v.ObjectSchema<{
+            readonly x: v.NumberSchema<undefined>;
+            readonly y: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+        readonly size: v.OptionalSchema<v.ObjectSchema<{
+            readonly w: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>]>;
+            readonly h: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>]>;
+        }, undefined>, undefined>;
+        readonly moduleName: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+        readonly fragmentIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>, undefined>;
+        readonly serviceFragmentIds: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>, undefined>;
+        readonly modelId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+        readonly mergePresetId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+        readonly pipelineId: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+        readonly agentConfig: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>, undefined>;
+        readonly testComposePath: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 400, undefined>]>, undefined>;
+        readonly noInfraDependencies: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly cloudProvider: v.OptionalSchema<v.PicklistSchema<["cloudflare", "docker", "aws", "gcp", "azure", "custom"], undefined>, undefined>;
+        readonly instanceSize: v.OptionalSchema<v.PicklistSchema<["small", "medium", "large", "xlarge"], undefined>, undefined>;
+    };
+    readonly "~standard": v.StandardProps<{
+        title?: string | undefined;
+        description?: string | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+        size?: {
+            w: number;
+            h: number;
+        } | undefined;
+        moduleName?: string | undefined;
+        fragmentIds?: string[] | undefined;
+        serviceFragmentIds?: string[] | undefined;
+        modelId?: string | undefined;
+        mergePresetId?: string | undefined;
+        pipelineId?: string | undefined;
+        agentConfig?: {
+            [x: string]: string;
+        } | undefined;
+        testComposePath?: string | undefined;
+        noInfraDependencies?: boolean | undefined;
+        cloudProvider?: "aws" | "azure" | "cloudflare" | "custom" | "docker" | "gcp" | undefined;
+        instanceSize?: "large" | "medium" | "small" | "xlarge" | undefined;
+    }, {
+        title?: string | undefined;
+        description?: string | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+        size?: {
+            w: number;
+            h: number;
+        } | undefined;
+        moduleName?: string | undefined;
+        fragmentIds?: string[] | undefined;
+        serviceFragmentIds?: string[] | undefined;
+        modelId?: string | undefined;
+        mergePresetId?: string | undefined;
+        pipelineId?: string | undefined;
+        agentConfig?: {
+            [x: string]: string;
+        } | undefined;
+        testComposePath?: string | undefined;
+        noInfraDependencies?: boolean | undefined;
+        cloudProvider?: "aws" | "azure" | "cloudflare" | "custom" | "docker" | "gcp" | undefined;
+        instanceSize?: "large" | "medium" | "small" | "xlarge" | undefined;
+    }>;
+    readonly "~run": (dataset: v.UnknownDataset, config: v.Config<v.BaseIssue<unknown>>) => v.OutputDataset<{
+        title?: string | undefined;
+        description?: string | undefined;
+        position?: {
+            x: number;
+            y: number;
+        } | undefined;
+        size?: {
+            w: number;
+            h: number;
+        } | undefined;
+        moduleName?: string | undefined;
+        fragmentIds?: string[] | undefined;
+        serviceFragmentIds?: string[] | undefined;
+        modelId?: string | undefined;
+        mergePresetId?: string | undefined;
+        pipelineId?: string | undefined;
+        agentConfig?: {
+            [x: string]: string;
+        } | undefined;
+        testComposePath?: string | undefined;
+        noInfraDependencies?: boolean | undefined;
+        cloudProvider?: "aws" | "azure" | "cloudflare" | "custom" | "docker" | "gcp" | undefined;
+        instanceSize?: "large" | "medium" | "small" | "xlarge" | undefined;
+    }, v.ArrayIssue | v.BooleanIssue | v.MaxLengthIssue<string, 120> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 400> | v.MaxLengthIssue<string, 2000> | v.MinLengthIssue<string, 1> | v.MinValueIssue<number, 1> | v.NumberIssue | v.ObjectIssue | v.PicklistIssue | v.RecordIssue | v.StringIssue>;
+    readonly "~types"?: {
+        readonly input: {
+            title?: string | undefined;
+            description?: string | undefined;
+            position?: {
+                x: number;
+                y: number;
+            } | undefined;
+            size?: {
+                w: number;
+                h: number;
+            } | undefined;
+            moduleName?: string | undefined;
+            fragmentIds?: string[] | undefined;
+            serviceFragmentIds?: string[] | undefined;
+            modelId?: string | undefined;
+            mergePresetId?: string | undefined;
+            pipelineId?: string | undefined;
+            agentConfig?: {
+                [x: string]: string;
+            } | undefined;
+            testComposePath?: string | undefined;
+            noInfraDependencies?: boolean | undefined;
+            cloudProvider?: "aws" | "azure" | "cloudflare" | "custom" | "docker" | "gcp" | undefined;
+            instanceSize?: "large" | "medium" | "small" | "xlarge" | undefined;
+        };
+        readonly output: {
+            title?: string | undefined;
+            description?: string | undefined;
+            position?: {
+                x: number;
+                y: number;
+            } | undefined;
+            size?: {
+                w: number;
+                h: number;
+            } | undefined;
+            moduleName?: string | undefined;
+            fragmentIds?: string[] | undefined;
+            serviceFragmentIds?: string[] | undefined;
+            modelId?: string | undefined;
+            mergePresetId?: string | undefined;
+            pipelineId?: string | undefined;
+            agentConfig?: {
+                [x: string]: string;
+            } | undefined;
+            testComposePath?: string | undefined;
+            noInfraDependencies?: boolean | undefined;
+            cloudProvider?: "aws" | "azure" | "cloudflare" | "custom" | "docker" | "gcp" | undefined;
+            instanceSize?: "large" | "medium" | "small" | "xlarge" | undefined;
+        };
+        readonly issue: v.ArrayIssue | v.BooleanIssue | v.MaxLengthIssue<string, 120> | v.MaxLengthIssue<string, 200> | v.MaxLengthIssue<string, 400> | v.MaxLengthIssue<string, 2000> | v.MinLengthIssue<string, 1> | v.MinValueIssue<number, 1> | v.NumberIssue | v.ObjectIssue | v.PicklistIssue | v.RecordIssue | v.StringIssue;
+    } | undefined;
+};
+export type UpdateBlockInput = v.InferOutput<typeof updateBlockSchema>;
+export declare const moveBlockSchema: v.ObjectSchema<{
+    readonly position: v.ObjectSchema<{
+        readonly x: v.NumberSchema<undefined>;
+        readonly y: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>;
+export type MoveBlockInput = v.InferOutput<typeof moveBlockSchema>;
+export declare const reparentSchema: v.ObjectSchema<{
+    readonly parentId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly position: v.ObjectSchema<{
+        readonly x: v.NumberSchema<undefined>;
+        readonly y: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>;
+export type ReparentInput = v.InferOutput<typeof reparentSchema>;
+export declare const toggleDependencySchema: v.ObjectSchema<{
+    readonly sourceId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type ToggleDependencyInput = v.InferOutput<typeof toggleDependencySchema>;
+export declare const createPipelineSchema: v.ObjectSchema<{
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+    readonly agentKinds: v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MinLengthAction<string[], 1, undefined>]>;
+    /**
+     * Per-step human approval gates, parallel to {@link agentKinds}. Optional;
+     * omitted means no gates (the pipeline runs straight through).
+     */
+    readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    /**
+     * Per-step companion quality thresholds (0..1), parallel to {@link agentKinds}.
+     * Only meaningful on companion steps; `null`/omitted means "use the companion's
+     * default threshold". Optional.
+     */
+    readonly thresholds: v.OptionalSchema<v.ArraySchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>, undefined>, undefined>;
+    /**
+     * Per-step enable flags, parallel to {@link agentKinds}. `false` keeps the step in
+     * the pipeline but skips it at run start. Optional; omitted means every step runs.
+     */
+    readonly enabled: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    /**
+     * Per-step consensus configs, parallel to {@link agentKinds}: a step whose kind carries
+     * a consensus capability trait may run through the multi-model consensus mechanism.
+     * `null`/omitted ⇒ the standard single-actor agent. Optional.
+     */
+    readonly consensus: v.OptionalSchema<v.ArraySchema<v.NullableSchema<v.ObjectSchema<{
+        readonly enabled: v.BooleanSchema<undefined>;
+        readonly strategy: v.PicklistSchema<["specialist-panel", "debate", "ranked-voting"], undefined>;
+        readonly participants: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly role: v.StringSchema<undefined>;
+            readonly systemFraming: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly modelId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly synthesizerModelId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly rounds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 5, undefined>]>, undefined>;
+        readonly gating: v.OptionalSchema<v.ObjectSchema<{
+            readonly enabled: v.BooleanSchema<undefined>;
+            readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["consensus", "standard"], undefined>, "consensus">;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>, undefined>;
+    /**
+     * Per-step estimate gating, parallel to {@link agentKinds}: an enabled entry makes the
+     * step run only when the task estimate meets the threshold. `null`/omitted ⇒ always run.
+     * A pipeline with any enabled gating requires a `task-estimator` step earlier in the
+     * chain or it is rejected. Optional.
+     */
+    readonly gating: v.OptionalSchema<v.ArraySchema<v.NullableSchema<v.ObjectSchema<{
+        readonly enabled: v.BooleanSchema<undefined>;
+        readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["run", "skip"], undefined>, "run">;
+    }, undefined>, undefined>, undefined>, undefined>;
+    /** Free-form organizational labels for the library. Optional. */
+    readonly labels: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>, undefined>;
+}, undefined>;
+export type CreatePipelineInput = v.InferOutput<typeof createPipelineSchema>;
+/**
+ * Edit an existing (non-built-in) pipeline. Every field is optional — only the
+ * supplied fields change; `agentKinds` (when present) replaces the whole chain and
+ * re-aligns the parallel arrays. Built-in pipelines reject this (clone them first).
+ */
+export declare const updatePipelineSchema: v.ObjectSchema<{
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+    readonly agentKinds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>, v.MinLengthAction<string[], 1, undefined>]>, undefined>;
+    readonly gates: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    readonly thresholds: v.OptionalSchema<v.ArraySchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>, undefined>, undefined>;
+    readonly enabled: v.OptionalSchema<v.ArraySchema<v.BooleanSchema<undefined>, undefined>, undefined>;
+    readonly consensus: v.OptionalSchema<v.ArraySchema<v.NullableSchema<v.ObjectSchema<{
+        readonly enabled: v.BooleanSchema<undefined>;
+        readonly strategy: v.PicklistSchema<["specialist-panel", "debate", "ranked-voting"], undefined>;
+        readonly participants: v.ArraySchema<v.ObjectSchema<{
+            readonly id: v.StringSchema<undefined>;
+            readonly role: v.StringSchema<undefined>;
+            readonly systemFraming: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly modelId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly synthesizerModelId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly rounds: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 5, undefined>]>, undefined>;
+        readonly gating: v.OptionalSchema<v.ObjectSchema<{
+            readonly enabled: v.BooleanSchema<undefined>;
+            readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+            readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["consensus", "standard"], undefined>, "consensus">;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>, undefined>, undefined>;
+    readonly gating: v.OptionalSchema<v.ArraySchema<v.NullableSchema<v.ObjectSchema<{
+        readonly enabled: v.BooleanSchema<undefined>;
+        readonly minComplexity: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        readonly minRisk: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        readonly minImpact: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 0, undefined>, v.MaxValueAction<number, 1, undefined>]>, undefined>;
+        readonly onMissingEstimate: v.OptionalSchema<v.PicklistSchema<["run", "skip"], undefined>, "run">;
+    }, undefined>, undefined>, undefined>, undefined>;
+    readonly labels: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>, undefined>;
+}, undefined>;
+export type UpdatePipelineInput = v.InferOutput<typeof updatePipelineSchema>;
+/** Clone any pipeline (built-in or custom) into a new, editable copy. */
+export declare const clonePipelineSchema: v.ObjectSchema<{
+    /** Name for the copy. Optional; defaults to "<source name> (copy)". */
+    readonly name: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>, undefined>;
+}, undefined>;
+export type ClonePipelineInput = v.InferOutput<typeof clonePipelineSchema>;
+/**
+ * Organize a pipeline in the library: set labels and/or archive state. The ONLY
+ * mutation allowed on a built-in pipeline (it touches view/organization metadata,
+ * not structure), so built-ins can be tagged/archived while staying read-only for
+ * their steps. Every field optional — only the supplied fields change.
+ */
+export declare const organizePipelineSchema: v.ObjectSchema<{
+    readonly labels: v.OptionalSchema<v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 40, undefined>]>, undefined>, undefined>;
+    readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+}, undefined>;
+export type OrganizePipelineInput = v.InferOutput<typeof organizePipelineSchema>;
+export declare const startExecutionSchema: v.ObjectSchema<{
+    readonly pipelineId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type StartExecutionInput = v.InferOutput<typeof startExecutionSchema>;
+export declare const resolveDecisionSchema: v.ObjectSchema<{
+    readonly choice: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+}, undefined>;
+export type ResolveDecisionInput = v.InferOutput<typeof resolveDecisionSchema>;
+/**
+ * Approve a step's gated proposal. An optional edited `proposal` overrides the
+ * agent's text, so the human's revision is what flows to downstream steps.
+ */
+export declare const approveStepSchema: v.ObjectSchema<{
+    readonly proposal: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 50000, undefined>]>, undefined>;
+}, undefined>;
+export type ApproveStepInput = v.InferOutput<typeof approveStepSchema>;
+/**
+ * Request changes on a gated proposal: the step re-runs with the reviewer's
+ * freeform `feedback` and/or per-block `comments`. At least one of the two must
+ * be present — an empty review changes nothing.
+ */
+export declare const requestStepChangesSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
+    readonly feedback: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 10000, undefined>]>, undefined>;
+    readonly comments: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        readonly quotedSource: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 20000, undefined>]>;
+        readonly srcStart: v.NumberSchema<undefined>;
+        readonly srcEnd: v.NumberSchema<undefined>;
+        readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 5000, undefined>]>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>, v.CheckAction<{
+    feedback?: string | undefined;
+    comments?: {
+        quotedSource: string;
+        srcStart: number;
+        srcEnd: number;
+        body: string;
+    }[] | undefined;
+}, "Provide freeform feedback or at least one comment">]>;
+export type RequestStepChangesInput = v.InferOutput<typeof requestStepChangesSchema>;
+/** Reject a gated proposal: the run stops entirely (a terminal failure). */
+export declare const rejectStepSchema: v.ObjectSchema<{
+    readonly reason: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+}, undefined>;
+export type RejectStepInput = v.InferOutput<typeof rejectStepSchema>;
+/**
+ * Restart a run from a chosen step: re-run from `fromStepIndex` onward, keeping the
+ * earlier steps (and their outputs) as handoff context and resetting that step plus
+ * every later one's iteration counters. The service validates the index against the
+ * run's real step count; this only enforces a non-negative integer up front.
+ */
+export declare const restartFromStepSchema: v.ObjectSchema<{
+    readonly fromStepIndex: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
+}, undefined>;
+export type RestartFromStepInput = v.InferOutput<typeof restartFromStepSchema>;
+//# sourceMappingURL=requests.d.ts.map

package/dist/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../src/requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAiB5B,eAAO,MAAM,qBAAqB;;IAEhC,oFAAoF;;IAEpF;;;;OAIG;;IAEH;;;;OAIG;;aAEH,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE9E,oDAAoD;AACpD,eAAO,MAAM,qBAAqB;;IAEhC,wEAAwE;;aAExE,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE9E,eAAO,MAAM,cAAc;;;;;;aAGzB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;IAGnC;;;;OAIG;;IAEH;;;;;OAKG;;aAEH,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEpF,eAAO,MAAM,aAAa;;;;;;;;;;;;;aAgBxB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,aAAa,CAAC,CAAA;AAE9D,eAAO,MAAM,eAAe;;;;;;aAG1B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAElE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B7B,CAAA;AACD,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEtE,eAAO,MAAM,eAAe;;;;;aAAyC,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,eAAe,CAAC,CAAA;AAElE,eAAO,MAAM,cAAc;;;;;;aAGzB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,cAAc,CAAC,CAAA;AAEhE,eAAO,MAAM,sBAAsB;;aAEjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAEhF,eAAO,MAAM,oBAAoB;;;IAG/B;;;OAGG;;IAEH;;;;OAIG;;IAEH;;;OAGG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;IAEH;;;;;OAKG;;;;;;;;IAEH,iEAAiE;;aAEjE,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE5E;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAS/B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAE5E,yEAAyE;AACzE,eAAO,MAAM,mBAAmB;IAC9B,uEAAuE;;aAEvE,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE1E;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;aAGjC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAEhF,eAAO,MAAM,oBAAoB;;aAE/B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAS5E,eAAO,MAAM,qBAAqB;;aAEhC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAE9E;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;aAE5B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAUtE;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;yDASpC,CAAA;AACD,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEpF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB;;aAE3B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;aAEhC,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAA"}