@w3kits-com/plugin-opendesign 0.1.11 → 0.1.12

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/critique.d.ts

@@ -0,0 +1,344 @@
+import { z } from 'zod';
+/**
+ * Local mirror of SseTransportEvent from './sse/common'. Re-defining the
+ * three-field interface avoids a cross-file relative import inside this leaf
+ * module: the daemon walks this file via the './critique' subpath export
+ * under NodeNext (which requires explicit '.js' extensions), while the web
+ * Turbopack build refuses to rewrite '.js' to '.ts' on the same source.
+ * Keeping the type local makes the file self-contained for both consumers.
+ */
+interface SseTransportEvent<Name extends string, Payload> {
+    id?: string;
+    event: Name;
+    data: Payload;
+}
+export declare const PANELIST_ROLES: readonly ["designer", "critic", "brand", "a11y", "copy"];
+export type PanelistRole = typeof PANELIST_ROLES[number];
+export declare const FALLBACK_POLICIES: readonly ["ship_best", "ship_last", "fail"];
+export type FallbackPolicy = typeof FALLBACK_POLICIES[number];
+export declare const CRITIQUE_PROTOCOL_VERSION = 1;
+export declare const RoleWeights: z.ZodObject<{
+    designer: z.ZodNumber;
+    critic: z.ZodNumber;
+    brand: z.ZodNumber;
+    a11y: z.ZodNumber;
+    copy: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    designer: number;
+    critic: number;
+    brand: number;
+    a11y: number;
+    copy: number;
+}, {
+    designer: number;
+    critic: number;
+    brand: number;
+    a11y: number;
+    copy: number;
+}>;
+export type RoleWeights = z.infer<typeof RoleWeights>;
+export declare const CritiqueConfigSchema: z.ZodEffects<z.ZodObject<{
+    enabled: z.ZodBoolean;
+    cast: z.ZodArray<z.ZodEnum<["designer", "critic", "brand", "a11y", "copy"]>, "many">;
+    maxRounds: z.ZodNumber;
+    scoreScale: z.ZodNumber;
+    scoreThreshold: z.ZodNumber;
+    weights: z.ZodObject<{
+        designer: z.ZodNumber;
+        critic: z.ZodNumber;
+        brand: z.ZodNumber;
+        a11y: z.ZodNumber;
+        copy: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        designer: number;
+        critic: number;
+        brand: number;
+        a11y: number;
+        copy: number;
+    }, {
+        designer: number;
+        critic: number;
+        brand: number;
+        a11y: number;
+        copy: number;
+    }>;
+    perRoundTimeoutMs: z.ZodNumber;
+    totalTimeoutMs: z.ZodNumber;
+    parserMaxBlockBytes: z.ZodNumber;
+    fallbackPolicy: z.ZodEnum<["ship_best", "ship_last", "fail"]>;
+    protocolVersion: z.ZodNumber;
+    maxConcurrentRuns: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    cast: ("designer" | "critic" | "brand" | "a11y" | "copy")[];
+    maxRounds: number;
+    scoreScale: number;
+    scoreThreshold: number;
+    weights: {
+        designer: number;
+        critic: number;
+        brand: number;
+        a11y: number;
+        copy: number;
+    };
+    perRoundTimeoutMs: number;
+    totalTimeoutMs: number;
+    parserMaxBlockBytes: number;
+    fallbackPolicy: "ship_best" | "ship_last" | "fail";
+    protocolVersion: number;
+    maxConcurrentRuns: number;
+}, {
+    enabled: boolean;
+    cast: ("designer" | "critic" | "brand" | "a11y" | "copy")[];
+    maxRounds: number;
+    scoreScale: number;
+    scoreThreshold: number;
+    weights: {
+        designer: number;
+        critic: number;
+        brand: number;
+        a11y: number;
+        copy: number;
+    };
+    perRoundTimeoutMs: number;
+    totalTimeoutMs: number;
+    parserMaxBlockBytes: number;
+    fallbackPolicy: "ship_best" | "ship_last" | "fail";
+    protocolVersion: number;
+    maxConcurrentRuns: number;
+}>, {
+    enabled: boolean;
+    cast: ("designer" | "critic" | "brand" | "a11y" | "copy")[];
+    maxRounds: number;
+    scoreScale: number;
+    scoreThreshold: number;
+    weights: {
+        designer: number;
+        critic: number;
+        brand: number;
+        a11y: number;
+        copy: number;
+    };
+    perRoundTimeoutMs: number;
+    totalTimeoutMs: number;
+    parserMaxBlockBytes: number;
+    fallbackPolicy: "ship_best" | "ship_last" | "fail";
+    protocolVersion: number;
+    maxConcurrentRuns: number;
+}, {
+    enabled: boolean;
+    cast: ("designer" | "critic" | "brand" | "a11y" | "copy")[];
+    maxRounds: number;
+    scoreScale: number;
+    scoreThreshold: number;
+    weights: {
+        designer: number;
+        critic: number;
+        brand: number;
+        a11y: number;
+        copy: number;
+    };
+    perRoundTimeoutMs: number;
+    totalTimeoutMs: number;
+    parserMaxBlockBytes: number;
+    fallbackPolicy: "ship_best" | "ship_last" | "fail";
+    protocolVersion: number;
+    maxConcurrentRuns: number;
+}>;
+export type CritiqueConfig = z.infer<typeof CritiqueConfigSchema>;
+export declare function defaultCritiqueConfig(): CritiqueConfig;
+export declare const DEGRADED_REASONS: readonly ["malformed_block", "oversize_block", "adapter_unsupported", "protocol_version_mismatch", "missing_artifact"];
+export type DegradedReason = typeof DEGRADED_REASONS[number];
+export declare const FAILED_CAUSES: readonly ["cli_exit_nonzero", "per_round_timeout", "total_timeout", "orchestrator_internal"];
+export type FailedCause = typeof FAILED_CAUSES[number];
+export declare const PARSER_WARNING_KINDS: readonly ["weak_debate", "unknown_role", "score_clamped", "composite_mismatch", "duplicate_ship"];
+export type ParserWarningKind = typeof PARSER_WARNING_KINDS[number];
+export declare const ROUND_DECISIONS: readonly ["continue", "ship"];
+export type RoundDecision = typeof ROUND_DECISIONS[number];
+export declare const SHIP_STATUSES: readonly ["shipped", "below_threshold", "timed_out", "interrupted"];
+export type ShipStatus = typeof SHIP_STATUSES[number];
+export type PanelEvent = {
+    type: 'run_started';
+    runId: string;
+    protocolVersion: number;
+    cast: PanelistRole[];
+    maxRounds: number;
+    threshold: number;
+    scale: number;
+} | {
+    type: 'panelist_open';
+    runId: string;
+    round: number;
+    role: PanelistRole;
+} | {
+    type: 'panelist_dim';
+    runId: string;
+    round: number;
+    role: PanelistRole;
+    dimName: string;
+    dimScore: number;
+    dimNote: string;
+} | {
+    type: 'panelist_must_fix';
+    runId: string;
+    round: number;
+    role: PanelistRole;
+    text: string;
+} | {
+    type: 'panelist_close';
+    runId: string;
+    round: number;
+    role: PanelistRole;
+    score: number;
+} | {
+    type: 'round_end';
+    runId: string;
+    round: number;
+    composite: number;
+    mustFix: number;
+    decision: RoundDecision;
+    reason: string;
+} | {
+    type: 'ship';
+    runId: string;
+    round: number;
+    composite: number;
+    status: ShipStatus;
+    artifactRef: {
+        projectId: string;
+        artifactId: string;
+    };
+    summary: string;
+} | {
+    type: 'degraded';
+    runId: string;
+    reason: DegradedReason;
+    adapter: string;
+} | {
+    type: 'interrupted';
+    runId: string;
+    bestRound: number;
+    composite: number;
+} | {
+    type: 'failed';
+    runId: string;
+    cause: FailedCause;
+} | {
+    type: 'parser_warning';
+    runId: string;
+    kind: ParserWarningKind;
+    position: number;
+};
+/**
+ * Strict runtime guard for the `PanelEvent` union. Validates the union tag
+ * (`type`), the non-empty `runId` header, every variant-specific required
+ * field, the membership of closed-enum fields (`role`, `status`, `reason`,
+ * `cause`, `kind`, `decision`), and the numeric domain of every numeric
+ * field (integer / positive / non-negative / range), not just finiteness.
+ *
+ * This is the single source of truth for wire-side validation. Both the web
+ * SSE path (`sseToPanelEvent`) and the transcript replay parser go through
+ * here, so a malformed frame (missing field, unknown enum value, NaN /
+ * Infinity score, `scale: 0` causing downstream divide-by-zero, threshold
+ * outside `[0, scale]`, fractional or negative round numbers) is rejected
+ * before any reducer or component touches it.
+ *
+ * Numeric domains enforced (lefarcen P2 on PR #1314 round 4):
+ *
+ *   - `protocolVersion`, `maxRounds`, `scale`, `round`: positive integers.
+ *     ScoreTicker divides by `scale` for inline CSS, so a `scale: 0` would
+ *     produce Infinity and ship as broken style; rounds are 1-indexed.
+ *   - `bestRound`, `mustFix`, `position`: non-negative integers. `bestRound:
+ *     0` is the valid "interrupt before any round closed" sentinel.
+ *   - `threshold`: non-negative finite; cross-checked `threshold <= scale`
+ *     inside `run_started`. Threshold is allowed to be fractional (e.g.
+ *     8.5 on a scale of 10).
+ *   - `composite`, `score`, `dimScore`: non-negative finite. The
+ *     `<= scale` bound is per-run state the guard does not see; downstream
+ *     code clamps to scale on render, but a negative score is never valid.
+ *
+ * Earlier review history:
+ *
+ *   - Siri-Ray round-3 P1: the original guard checked `typeof === 'string'`
+ *     for enum fields and accepted unknown values; now validated against
+ *     the closed-set arrays.
+ */
+export declare function isPanelEvent(value: unknown): value is PanelEvent;
+type PayloadOf<T extends PanelEvent['type']> = Omit<Extract<PanelEvent, {
+    type: T;
+}>, 'type'>;
+export type CritiqueSseEvent = SseTransportEvent<'critique.run_started', PayloadOf<'run_started'>> | SseTransportEvent<'critique.panelist_open', PayloadOf<'panelist_open'>> | SseTransportEvent<'critique.panelist_dim', PayloadOf<'panelist_dim'>> | SseTransportEvent<'critique.panelist_must_fix', PayloadOf<'panelist_must_fix'>> | SseTransportEvent<'critique.panelist_close', PayloadOf<'panelist_close'>> | SseTransportEvent<'critique.round_end', PayloadOf<'round_end'>> | SseTransportEvent<'critique.ship', PayloadOf<'ship'>> | SseTransportEvent<'critique.degraded', PayloadOf<'degraded'>> | SseTransportEvent<'critique.interrupted', PayloadOf<'interrupted'>> | SseTransportEvent<'critique.failed', PayloadOf<'failed'>> | SseTransportEvent<'critique.parser_warning', PayloadOf<'parser_warning'>>;
+export declare const CRITIQUE_SSE_EVENT_NAMES: readonly ["critique.run_started", "critique.panelist_open", "critique.panelist_dim", "critique.panelist_must_fix", "critique.panelist_close", "critique.round_end", "critique.ship", "critique.degraded", "critique.interrupted", "critique.failed", "critique.parser_warning"];
+export type CritiqueSseEventName = typeof CRITIQUE_SSE_EVENT_NAMES[number];
+export declare function panelEventToSse(e: PanelEvent): CritiqueSseEvent;
+/**
+ * Per-round summary persisted with each critique run. Mirrors the shape the
+ * orchestrator writes via decideRound; web clients consume it through the
+ * rerun and history endpoints, so it lives in the shared contract layer.
+ */
+export interface CritiqueRoundSummary {
+    n: number;
+    composite: number;
+    mustFix: number;
+    decision: RoundDecision;
+}
+/**
+ * Terminal critique status persisted with each run. Superset of ShipStatus
+ * that also covers degraded / failed / legacy outcomes. The daemon's CHECK
+ * constraint also accepts the in-flight 'running' value, but that is handled
+ * inline by daemon-side code; the public contract surface is terminal-only
+ * because every consumer of this type works against finished runs.
+ */
+export type CritiqueRunStatus = ShipStatus | 'degraded' | 'failed' | 'legacy';
+/**
+ * Enumeration of every terminal CritiqueRunStatus value, in the order the
+ * UI / docs / status filters typically display them: SHIP outcomes first
+ * (shipped → below_threshold → timed_out → interrupted), then quality /
+ * lifecycle exits (degraded → failed), then the historical 'legacy' tag
+ * for runs created before the feature shipped. Web consumers (status
+ * filters, analytics dashboards) iterate this constant directly so the
+ * daemon stays the single source of truth on the order.
+ */
+export declare const CRITIQUE_RUN_STATUSES: readonly ["shipped", "below_threshold", "timed_out", "interrupted", "degraded", "failed", "legacy"];
+/**
+ * Compile-time guarantee that every `CritiqueRunStatus` variant appears in
+ * `CRITIQUE_RUN_STATUSES`. `satisfies` only proves each listed value is
+ * valid; this assertion proves the list is exhaustive, so adding a new
+ * variant to `CritiqueRunStatus` (or `ShipStatus`) without updating the
+ * array fails the build with a tuple naming the missing variants. Picked
+ * up from lefarcen P3 on PR #1016. The exported helper type is reusable
+ * by other shared enums (e.g. `PANELIST_ROLES`) once they need the same
+ * guard.
+ */
+export type AssertExhaustiveValues<T extends string, U extends readonly T[]> = Exclude<T, U[number]> extends never ? true : ['Missing variants in array:', Exclude<T, U[number]>];
+/**
+ * Internal-to-the-daemon row status. Adds the in-flight `'running'` value
+ * the DB CHECK constraint accepts to the public `CritiqueRunStatus` union
+ * so DB-row types can be precisely typed without inline `as X | 'running'`
+ * widens at every call site. Every public DTO continues to use the
+ * terminal-only `CritiqueRunStatus` so a future endpoint cannot leak a
+ * 'running' row through the wire. Picked up from lefarcen P2 on PR #1016.
+ */
+export type CritiquePersistedStatus = CritiqueRunStatus | 'running';
+/**
+ * Logical handle the daemon hands to the web layer for a critique run's
+ * shipped artifact. Web clients never see daemon filesystem paths; they
+ * fetch the artifact bytes via the `url` field, which the daemon serves
+ * with the right `Content-Type` header derived from `mime`. Returned by
+ * the rerun endpoint and the `GET /api/projects/:projectId/critique/:runId/artifact`
+ * route that streams the bytes.
+ */
+export interface CritiqueArtifactRef {
+    /** The owning project; matches the URL segment. */
+    projectId: string;
+    /** The owning critique run; matches the URL segment. */
+    runId: string;
+    /** Content-Type announced by the agent in `<ARTIFACT mime="…">`. */
+    mime: string;
+    /** Size of the artifact body in bytes, as written to disk. */
+    sizeBytes: number;
+    /** Daemon-relative HTTP path the web layer fetches to stream the bytes. */
+    url: string;
+}
+export {};
+//# sourceMappingURL=critique.d.ts.map

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/critique.d.ts.map

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

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/critique.mjs

@@ -0,0 +1,182 @@
+// src/critique.ts
+import { z } from "zod";
+var PANELIST_ROLES = ["designer", "critic", "brand", "a11y", "copy"];
+var FALLBACK_POLICIES = ["ship_best", "ship_last", "fail"];
+var CRITIQUE_PROTOCOL_VERSION = 1;
+var RoleWeights = z.object({
+  designer: z.number().min(0).max(1),
+  critic: z.number().min(0).max(1),
+  brand: z.number().min(0).max(1),
+  a11y: z.number().min(0).max(1),
+  copy: z.number().min(0).max(1)
+});
+var CritiqueConfigSchema = z.object({
+  enabled: z.boolean(),
+  cast: z.array(z.enum(PANELIST_ROLES)).min(1),
+  maxRounds: z.number().int().min(1).max(10),
+  scoreScale: z.number().int().min(1).max(100),
+  scoreThreshold: z.number().min(0).max(100).describe("Must be <= scoreScale; enforced by cross-field refine"),
+  weights: RoleWeights,
+  perRoundTimeoutMs: z.number().int().min(1e3),
+  totalTimeoutMs: z.number().int().min(1e3),
+  parserMaxBlockBytes: z.number().int().min(1024),
+  fallbackPolicy: z.enum(FALLBACK_POLICIES),
+  protocolVersion: z.number().int().min(1),
+  maxConcurrentRuns: z.number().int().min(1)
+}).refine(
+  // Small epsilon tolerance so a fractional threshold that rounds up against an
+  // integer scale (e.g. 8.0 with floating-point slack) still validates. The
+  // semantic check is "threshold cannot meaningfully exceed scale".
+  (cfg) => cfg.scoreThreshold <= cfg.scoreScale + 1e-9,
+  { message: "scoreThreshold must be <= scoreScale" }
+);
+function defaultCritiqueConfig() {
+  return {
+    enabled: false,
+    cast: [...PANELIST_ROLES],
+    maxRounds: 3,
+    scoreScale: 10,
+    scoreThreshold: 8,
+    weights: { designer: 0, critic: 0.4, brand: 0.2, a11y: 0.2, copy: 0.2 },
+    perRoundTimeoutMs: 9e4,
+    totalTimeoutMs: 24e4,
+    parserMaxBlockBytes: 262144,
+    fallbackPolicy: "ship_best",
+    protocolVersion: CRITIQUE_PROTOCOL_VERSION,
+    // Contracts layer cannot call os.cpus(); daemon env layer overrides via OD_CRITIQUE_MAX_CONCURRENT_RUNS.
+    maxConcurrentRuns: 4
+  };
+}
+var DEGRADED_REASONS = [
+  "malformed_block",
+  "oversize_block",
+  "adapter_unsupported",
+  "protocol_version_mismatch",
+  "missing_artifact"
+];
+var FAILED_CAUSES = [
+  "cli_exit_nonzero",
+  "per_round_timeout",
+  "total_timeout",
+  "orchestrator_internal"
+];
+var PARSER_WARNING_KINDS = [
+  "weak_debate",
+  "unknown_role",
+  "score_clamped",
+  "composite_mismatch",
+  "duplicate_ship"
+];
+var ROUND_DECISIONS = ["continue", "ship"];
+var SHIP_STATUSES = [
+  "shipped",
+  "below_threshold",
+  "timed_out",
+  "interrupted"
+];
+var PANEL_EVENT_TYPE_LIST = [
+  "run_started",
+  "panelist_open",
+  "panelist_dim",
+  "panelist_must_fix",
+  "panelist_close",
+  "round_end",
+  "ship",
+  "degraded",
+  "interrupted",
+  "failed",
+  "parser_warning"
+];
+var PANEL_EVENT_TYPES = new Set(PANEL_EVENT_TYPE_LIST);
+var PANELIST_ROLE_SET = new Set(PANELIST_ROLES);
+var SHIP_STATUS_SET = new Set(SHIP_STATUSES);
+var DEGRADED_REASON_SET = new Set(DEGRADED_REASONS);
+var FAILED_CAUSE_SET = new Set(FAILED_CAUSES);
+var PARSER_WARNING_KIND_SET = new Set(PARSER_WARNING_KINDS);
+var ROUND_DECISION_SET = new Set(ROUND_DECISIONS);
+var isFiniteNumber = (v) => typeof v === "number" && Number.isFinite(v);
+var isNonNegativeFinite = (v) => isFiniteNumber(v) && v >= 0;
+var isNonNegativeInt = (v) => isFiniteNumber(v) && Number.isInteger(v) && v >= 0;
+var isPositiveInt = (v) => isFiniteNumber(v) && Number.isInteger(v) && v > 0;
+var isString = (v) => typeof v === "string";
+var isPanelistRole = (v) => isString(v) && PANELIST_ROLE_SET.has(v);
+function isPanelEvent(value) {
+  if (!value || typeof value !== "object") return false;
+  const o = value;
+  const t = o["type"];
+  if (typeof t !== "string" || !PANEL_EVENT_TYPES.has(t)) return false;
+  const runId = o["runId"];
+  if (typeof runId !== "string" || runId.length === 0) return false;
+  switch (t) {
+    case "run_started": {
+      const threshold = o["threshold"];
+      const scale = o["scale"];
+      return isPositiveInt(o["protocolVersion"]) && Array.isArray(o["cast"]) && o["cast"].length > 0 && o["cast"].every(isPanelistRole) && isPositiveInt(o["maxRounds"]) && isPositiveInt(scale) && isNonNegativeFinite(threshold) && threshold <= scale;
+    }
+    case "panelist_open":
+      return isPositiveInt(o["round"]) && isPanelistRole(o["role"]);
+    case "panelist_dim":
+      return isPositiveInt(o["round"]) && isPanelistRole(o["role"]) && isString(o["dimName"]) && isNonNegativeFinite(o["dimScore"]) && isString(o["dimNote"]);
+    case "panelist_must_fix":
+      return isPositiveInt(o["round"]) && isPanelistRole(o["role"]) && isString(o["text"]);
+    case "panelist_close":
+      return isPositiveInt(o["round"]) && isPanelistRole(o["role"]) && isNonNegativeFinite(o["score"]);
+    case "round_end":
+      return isPositiveInt(o["round"]) && isNonNegativeFinite(o["composite"]) && isNonNegativeInt(o["mustFix"]) && isString(o["decision"]) && ROUND_DECISION_SET.has(o["decision"]) && isString(o["reason"]);
+    case "ship": {
+      const ref = o["artifactRef"];
+      return isPositiveInt(o["round"]) && isNonNegativeFinite(o["composite"]) && isString(o["status"]) && SHIP_STATUS_SET.has(o["status"]) && ref !== null && typeof ref === "object" && typeof ref.projectId === "string" && ref.projectId.length > 0 && typeof ref.artifactId === "string" && ref.artifactId.length > 0 && isString(o["summary"]);
+    }
+    case "degraded":
+      return isString(o["reason"]) && DEGRADED_REASON_SET.has(o["reason"]) && isString(o["adapter"]);
+    case "interrupted":
+      return isNonNegativeInt(o["bestRound"]) && isNonNegativeFinite(o["composite"]);
+    case "failed":
+      return isString(o["cause"]) && FAILED_CAUSE_SET.has(o["cause"]);
+    case "parser_warning":
+      return isString(o["kind"]) && PARSER_WARNING_KIND_SET.has(o["kind"]) && isNonNegativeInt(o["position"]);
+  }
+}
+var CRITIQUE_SSE_EVENT_NAMES = [
+  "critique.run_started",
+  "critique.panelist_open",
+  "critique.panelist_dim",
+  "critique.panelist_must_fix",
+  "critique.panelist_close",
+  "critique.round_end",
+  "critique.ship",
+  "critique.degraded",
+  "critique.interrupted",
+  "critique.failed",
+  "critique.parser_warning"
+];
+function panelEventToSse(e) {
+  const { type, ...payload } = e;
+  return { event: `critique.${type}`, data: payload };
+}
+var CRITIQUE_RUN_STATUSES = [
+  "shipped",
+  "below_threshold",
+  "timed_out",
+  "interrupted",
+  "degraded",
+  "failed",
+  "legacy"
+];
+export {
+  CRITIQUE_PROTOCOL_VERSION,
+  CRITIQUE_RUN_STATUSES,
+  CRITIQUE_SSE_EVENT_NAMES,
+  CritiqueConfigSchema,
+  DEGRADED_REASONS,
+  FAILED_CAUSES,
+  FALLBACK_POLICIES,
+  PANELIST_ROLES,
+  PARSER_WARNING_KINDS,
+  ROUND_DECISIONS,
+  RoleWeights,
+  SHIP_STATUSES,
+  defaultCritiqueConfig,
+  isPanelEvent,
+  panelEventToSse
+};

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/errors.d.ts

@@ -0,0 +1,40 @@
+import type { JsonValue } from './common.js';
+export declare const API_ERROR_CODES: readonly ["BAD_REQUEST", "UNAUTHORIZED", "FORBIDDEN", "NOT_FOUND", "CONFLICT", "PAYLOAD_TOO_LARGE", "UNSUPPORTED_MEDIA_TYPE", "VALIDATION_FAILED", "AGENT_UNAVAILABLE", "AGENT_AUTH_REQUIRED", "AGENT_EXECUTION_FAILED", "AGENT_PROMPT_TOO_LARGE", "PROJECT_NOT_FOUND", "FILE_NOT_FOUND", "ARTIFACT_NOT_FOUND", "ARTIFACT_REGRESSION", "UPSTREAM_UNAVAILABLE", "RATE_LIMITED", "DESKTOP_AUTH_PENDING", "TOOL_TOKEN_MISSING", "TOOL_TOKEN_INVALID", "TOOL_TOKEN_EXPIRED", "TOOL_ENDPOINT_DENIED", "TOOL_OPERATION_DENIED", "LIVE_ARTIFACT_NOT_FOUND", "LIVE_ARTIFACT_INVALID", "LIVE_ARTIFACT_STORAGE_FAILED", "LIVE_ARTIFACT_REFRESH_UNAVAILABLE", "LIVE_ARTIFACT_REFRESH_TIMEOUT", "REFRESH_LOCKED", "REFRESH_TIMED_OUT", "REFRESH_FAILED", "OUTPUT_TOO_LARGE", "TEMPLATE_BINDING_INVALID", "REDACTION_REQUIRED", "CONNECTOR_NOT_FOUND", "CONNECTOR_NOT_CONNECTED", "CONNECTOR_DISABLED", "CONNECTOR_TOOL_NOT_FOUND", "CONNECTOR_SAFETY_DENIED", "CONNECTOR_INPUT_SCHEMA_MISMATCH", "CONNECTOR_RATE_LIMITED", "CONNECTOR_OUTPUT_TOO_LARGE", "CONNECTOR_EXECUTION_FAILED", "INTERNAL_ERROR"];
+export type ApiErrorCode = (typeof API_ERROR_CODES)[number];
+export interface ApiError {
+    code: ApiErrorCode;
+    message: string;
+    details?: JsonValue;
+    retryable?: boolean;
+    requestId?: string;
+    taskId?: string;
+}
+export interface ApiErrorResponse {
+    error: ApiError;
+}
+export type ApiValidationIssue = {
+    /** Dot/bracket path, JSON pointer, or form field name that failed validation. */
+    path: string;
+    message: string;
+    code?: string;
+};
+export type ApiValidationErrorDetails = {
+    kind: 'validation';
+    issues: ApiValidationIssue[];
+};
+/** Success payload or shared error envelope for agent-facing daemon tool endpoints. */
+export type AgentToolApiResponse<TSuccess> = TSuccess | ApiErrorResponse;
+export type LegacyErrorResponse = {
+    error: string;
+} | {
+    code: string;
+    error: string;
+};
+export type CompatibleErrorResponse = ApiErrorResponse | LegacyErrorResponse;
+export interface SseErrorPayload {
+    message: string;
+    error?: ApiError;
+}
+export declare function createApiError(code: ApiErrorCode, message: string, init?: Omit<ApiError, 'code' | 'message'>): ApiError;
+export declare function createApiErrorResponse(error: ApiError): ApiErrorResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,eAAe,8hCA4DlB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,oBAAoB,CAAC,QAAQ,IAAI,QAAQ,GAAG,gBAAgB,CAAC;AAEzE,MAAM,MAAM,mBAAmB,GAC3B;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAM,GAAG,QAAQ,CAE3H;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,gBAAgB,CAExE"}

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/examples.d.ts

@@ -0,0 +1,20 @@
+import type { ChatRequest } from './api/chat';
+import type { ConnectorDetail } from './api/connectors';
+import type { ProjectFile } from './api/files';
+import type { LiveArtifact, LiveArtifactCreateInput, LiveArtifactUpdateInput } from './api/live-artifacts';
+import type { HealthResponse } from './api/registry';
+import type { ApiErrorResponse } from './errors';
+import type { ChatSseEvent } from './sse/chat';
+import type { ProxySseEvent } from './sse/proxy';
+export declare const exampleChatRequest: ChatRequest;
+export declare const exampleProjectFile: ProjectFile;
+export declare const exampleChatSseEvents: ChatSseEvent[];
+export declare const exampleProxySseEvents: ProxySseEvent[];
+export declare const exampleApiErrorResponse: ApiErrorResponse;
+export declare const exampleLiveArtifactValidationErrorResponse: ApiErrorResponse;
+export declare const exampleHealthResponse: HealthResponse;
+export declare const exampleLiveArtifact: LiveArtifact;
+export declare const exampleLiveArtifactCreateInput: LiveArtifactCreateInput;
+export declare const exampleLiveArtifactUpdateInput: LiveArtifactUpdateInput;
+export declare const exampleConnectorDetail: ConnectorDetail;
+//# sourceMappingURL=examples.d.ts.map

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../src/examples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAA6B,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,kBAAkB,EAAE,WAShC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAQhC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAAY,EAK9C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,aAAa,EAIhD,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAMrC,CAAC;AAaF,eAAO,MAAM,0CAA0C,EAAE,gBAOxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAAgD,CAAC;AAErF,eAAO,MAAM,mBAAmB,EAAE,YAuBjC,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,uBAgB5C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,uBAI5C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,eAgCpC,CAAC"}

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/index.d.ts

@@ -0,0 +1,31 @@
+export * from './common';
+export * from './errors';
+export * from './tasks';
+export * from './api/app-config';
+export * from './api/artifacts';
+export * from './api/chat';
+export * from './api/connectors';
+export * from './api/comments';
+export * from './api/connectionTest';
+export * from './api/files';
+export * from './api/finalize';
+export * from './api/live-artifacts';
+export * from './api/mcp';
+export * from './api/memory';
+export * from './api/orbit';
+export * from './api/providerModels';
+export * from './api/projects';
+export * from './api/proxy';
+export * from './api/routines';
+export * from './api/registry';
+export * from './api/research';
+export * from './api/version';
+export * from './examples';
+export * from './sse/common';
+export * from './sse/chat';
+export * from './sse/proxy';
+export * from './prompts/system';
+export * from './critique';
+export * from './analytics/events';
+export * from './analytics/public-params';
+//# sourceMappingURL=index.d.ts.map

package/dist/__w3kits/webcontainer-runtime/workspace-packages/@open-design/contracts/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}