@autoview/cli 0.1.0

package/lib/orchestrate/orchestrateAutoViewSdkStudy.js

@@ -0,0 +1,85 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orchestrateAutoViewSdkStudy = orchestrateAutoViewSdkStudy;
+exports.renderSdkMapMarkdown = renderSdkMapMarkdown;
+const uuid_1 = require("uuid");
+const buildDeterministicSdkMap_1 = require("./utils/buildDeterministicSdkMap");
+/**
+ * Phase 1 of the AutoView agent — SDK Study (deterministic).
+ *
+ * Derives the SDK domain map (resources / actors / journeys) structurally from
+ * the OpenAPI document instead of asking an LLM to read the compiled SDK. This
+ * is what lets a large swagger run at all: the former LLM study put the WHOLE
+ * SDK source in one prompt (300k+ tokens on a ~200-type spec) and hit a hard
+ * context overflow before Product Plan even began. The downstream phases use
+ * only the map's structure (Product Plan reads `actors[0].name`; Render reads an
+ * actor's journeys on its rerender fallback; Scaffold/Review embed it as a wiki
+ * document), so deriving it deterministically changes nothing the user sees —
+ * except that it always works, costs no tokens, and is reproducible.
+ *
+ * Kept `async` to preserve the orchestrator's call shape.
+ */
+function orchestrateAutoViewSdkStudy(ctx, props) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const map = (0, buildDeterministicSdkMap_1.buildDeterministicSdkMap)(props.document);
+        const summary = `Deterministic SDK map — ${map.resources.length} resources, ${map.actors.length} actor(s), derived structurally from the OpenAPI document (no LLM).`;
+        const markdown = renderSdkMapMarkdown(summary, map);
+        ctx.dispatch({
+            type: "autoViewSdkStudy",
+            id: (0, uuid_1.v7)(),
+            created_at: new Date().toISOString(),
+            step: props.step,
+            resources: map.resources.length,
+            actors: map.actors.length,
+            sdkMap: markdown,
+        });
+        return { map, markdown };
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* markdown rendering for the event payload                                   */
+/* -------------------------------------------------------------------------- */
+function renderSdkMapMarkdown(summary, map) {
+    const lines = [
+        "# SDK Domain Map",
+        "",
+        summary.trim(),
+        "",
+        "## Actors",
+        "",
+    ];
+    for (const actor of map.actors) {
+        lines.push(`### ${actor.name}`, "");
+        for (const journey of actor.journeys) {
+            lines.push(`- ${journey}`);
+        }
+        lines.push("");
+    }
+    lines.push("## Resources", "");
+    for (const resource of map.resources) {
+        lines.push(`### ${resource.name}  \`${resource.namespace}\``, "");
+        lines.push(`- **Purpose**: ${resource.purpose}`);
+        lines.push(`- **Actors**: ${resource.actorsInvolved.join(", ") || "(none)"}`);
+        if (resource.notes.trim().length > 0) {
+            lines.push(`- **Notes**: ${resource.notes}`);
+        }
+        lines.push("");
+    }
+    if (map.notableConstraints.length > 0) {
+        lines.push("## Notable constraints", "");
+        for (const c of map.notableConstraints) {
+            lines.push(`- ${c}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=orchestrateAutoViewSdkStudy.js.map

package/lib/orchestrate/orchestrateAutoViewSdkStudy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrateAutoViewSdkStudy.js","sourceRoot":"","sources":["../../src/orchestrate/orchestrateAutoViewSdkStudy.ts"],"names":[],"mappings":";;;;;;;;;;;AAuBA,kEAsBC;AAMD,oDAsCC;AAvFD,+BAA0B;AAG1B,+EAA4E;AAG5E;;;;;;;;;;;;;;GAcG;AACH,SAAsB,2BAA2B,CAC/C,GAA0B,EAC1B,KAGC;;QAED,MAAM,GAAG,GAAG,IAAA,mDAAwB,EAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,2BAA2B,GAAG,CAAC,SAAS,CAAC,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC,MAAM,qEAAqE,CAAC;QACrK,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAEpD,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,kBAAkB;YACxB,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM;YAC/B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;YACzB,MAAM,EAAE,QAAQ;SACqB,CAAC,CAAC;QAEzC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC3B,CAAC;CAAA;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,SAAgB,oBAAoB,CAClC,OAAe,EACf,GAAoB;IAEpB,MAAM,KAAK,GAAa;QACtB,kBAAkB;QAClB,EAAE;QACF,OAAO,CAAC,IAAI,EAAE;QACd,EAAE;QACF,WAAW;QACX,EAAE;KACH,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CACR,iBAAiB,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAClE,CAAC;QACF,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,GAAG,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/lib/orchestrate/structures/IAutoViewProductPlan.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Structured output of the AutoView Product Plan phase.
+ *
+ * Encodes the information architecture of the frontend product the agent
+ * intends to build on top of the SDK: which screens exist, what each screen
+ * does, which navigation surfaces an actor sees, and which endpoints are
+ * intentionally left out.
+ *
+ * Consumed verbatim by the Scaffold (file layout) and Render (per-screen TSX)
+ * phases.
+ *
+ * @author Samchon
+ */
+export interface IAutoViewProductPlan {
+    /** All screens the product exposes. Ordered for downstream rendering. */
+    screens: IAutoViewProductPlan.IScreen[];
+    /**
+     * Top-level navigation entries grouped by actor. Each entry lists the screens
+     * reachable from the actor's primary nav.
+     */
+    navigation: IAutoViewProductPlan.INavigation[];
+    /**
+     * SDK endpoints (or whole resources) the plan deliberately leaves out, with a
+     * reason. Allows downstream phases and the operator to audit "omitted, not
+     * broken".
+     */
+    intentionalOmissions: IAutoViewProductPlan.IOmission[];
+}
+export declare namespace IAutoViewProductPlan {
+    type UiPattern = "landing" | "catalog" | "detail" | "form" | "table" | "wizard" | "dashboard";
+    interface IScreen {
+        /**
+         * Next.js App Router path, e.g. `/catalog`, `/orders/[id]`,
+         * `/seller/sales`. Dynamic segments use bracket syntax.
+         */
+        path: string;
+        /** Human-readable nav label (e.g. `"Catalog"`, `"Order detail"`). */
+        title: string;
+        /** One sentence: what does the user accomplish on this screen? */
+        purpose: string;
+        /**
+         * Actor name from {@link IAutoViewSdkMap.IActor.name}. Exactly one actor per
+         * screen — split when multiple actors need distinct views of the same
+         * data.
+         */
+        actor: string;
+        /**
+         * SDK accessor paths the screen will compose, e.g.
+         * `["shoppings.customers.sales.index",
+         * "shoppings.customers.channels.index"]`. Order is significant: the first
+         * entry is the primary data source.
+         */
+        endpoints: string[];
+        /**
+         * Closest fit from {@link UiPattern}. The Render phase reads this to pick
+         * shadcn primitives.
+         */
+        uiPattern: UiPattern;
+        /**
+         * Free-form notes for the Render phase: required filters, empty-state copy
+         * hints, multi-step flows, etc. Empty string is fine.
+         */
+        notes: string;
+        /**
+         * Resource hierarchy depth: 1 = a top-level resource (a landing-hub card),
+         * ≥2 = a nested resource reached from its parent's detail. Absent on the
+         * synthetic landing screen. Decides what belongs on the home hub — a
+         * structural fact, not a path-string guess.
+         */
+        depth?: number;
+    }
+    interface INavigation {
+        /** Actor whose nav this describes. */
+        actor: string;
+        /**
+         * Screen paths (subset of {@link IAutoViewProductPlan.screens}' `path`
+         * values) that appear on this actor's primary nav, in the order they should
+         * render.
+         */
+        primary: string[];
+        /**
+         * Screen paths reachable through a secondary path (drawer, profile menu,
+         * etc.). May be empty.
+         */
+        secondary: string[];
+    }
+    interface IOmission {
+        /**
+         * What is being omitted — a resource name, an accessor path, or a short
+         * descriptive label.
+         */
+        target: string;
+        /** One sentence explaining why it is out of product scope. */
+        reason: string;
+    }
+}

package/lib/orchestrate/structures/IAutoViewProductPlan.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAutoViewProductPlan.js.map

package/lib/orchestrate/structures/IAutoViewProductPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoViewProductPlan.js","sourceRoot":"","sources":["../../../src/orchestrate/structures/IAutoViewProductPlan.ts"],"names":[],"mappings":""}

package/lib/orchestrate/structures/IAutoViewProductPlanApplication.d.ts

@@ -0,0 +1,38 @@
+import { IAutoViewProductPlan } from "./IAutoViewProductPlan";
+/**
+ * LLM function-calling surface for the AutoView Product Plan phase.
+ *
+ * The agent calls `buildProductPlan` exactly once with a completed
+ * {@link IAutoViewProductPlan} after reading the SDK map produced by the SDK
+ * Study phase. The orchestrator validates the plan against the actual SDK shape
+ * (every screen references real accessors, every actor is declared) before
+ * handing it to the Scaffold phase.
+ *
+ * @author Samchon
+ */
+export interface IAutoViewProductPlanApplication {
+    /**
+     * Emit the structured information architecture of the frontend product.
+     *
+     * Call this exactly once. The plan must list every screen the product
+     * exposes, the per-actor navigation, and any deliberate omissions with a
+     * one-sentence reason.
+     *
+     * @param props The completed plan plus a short narrative summary.
+     */
+    buildProductPlan(props: IAutoViewProductPlanApplication.IProps): void;
+}
+export declare namespace IAutoViewProductPlanApplication {
+    interface IProps {
+        /**
+         * 2–4 sentence narrative summary of the product in the operator's voice —
+         * what kind of application is being built, which actors it serves, and what
+         * intentional shape decisions were made. Surfaced verbatim in the
+         * `autoViewProductPlan` event so the operator can sanity-check before
+         * authorizing scaffold/render.
+         */
+        summary: string;
+        /** The structured product plan. */
+        plan: IAutoViewProductPlan;
+    }
+}

package/lib/orchestrate/structures/IAutoViewProductPlanApplication.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAutoViewProductPlanApplication.js.map

package/lib/orchestrate/structures/IAutoViewProductPlanApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoViewProductPlanApplication.js","sourceRoot":"","sources":["../../../src/orchestrate/structures/IAutoViewProductPlanApplication.ts"],"names":[],"mappings":""}

package/lib/orchestrate/structures/IAutoViewRenderApplication.d.ts

@@ -0,0 +1,38 @@
+/**
+ * LLM function-calling surface for the AutoView Render phase.
+ *
+ * Each screen from {@link IAutoViewProductPlan.screens} is rendered by an
+ * isolated LLM call. The model returns the complete TSX source as one string;
+ * the orchestrator parses it with TypeScript and re-invokes the model with the
+ * diagnostic when the source fails to parse.
+ *
+ * @author Samchon
+ */
+export interface IAutoViewRenderApplication {
+    /**
+     * Emit the complete TSX source for one Next.js page.
+     *
+     * Call this exactly once per screen. The returned source must include `"use
+     * client";`, a single default `Page` export, every import the file uses, and
+     * explicit handling of the four UI states (loading / error / empty / data).
+     *
+     * @param props The TSX source plus a short rationale.
+     */
+    renderPage(props: IAutoViewRenderApplication.IProps): void;
+}
+export declare namespace IAutoViewRenderApplication {
+    interface IProps {
+        /**
+         * One-line rationale explaining the rendering choices for this screen —
+         * which shadcn primitives were composed, why pagination vs. infinite
+         * scroll, etc. Surfaced in the `autoViewRenderPage` event so the operator
+         * can audit decisions without reading every TSX file.
+         */
+        rationale: string;
+        /**
+         * Complete TSX source for the page. Starts with `"use client";` and exports
+         * a single default `Page` function.
+         */
+        tsx: string;
+    }
+}

package/lib/orchestrate/structures/IAutoViewRenderApplication.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAutoViewRenderApplication.js.map

package/lib/orchestrate/structures/IAutoViewRenderApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoViewRenderApplication.js","sourceRoot":"","sources":["../../../src/orchestrate/structures/IAutoViewRenderApplication.ts"],"names":[],"mappings":""}

package/lib/orchestrate/structures/IAutoViewReviewApplication.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LLM function-calling surface for the AutoView UI Review phase.
+ *
+ * The agent calls `writeSdkFeedback` exactly once after the Render phase
+ * finishes. The orchestrator drops the returned markdown into
+ * `frontend/wiki/sdk-feedback.md` verbatim and surfaces the narrative summary
+ * in the `autoViewReview` event.
+ *
+ * @author Samchon
+ */
+export interface IAutoViewReviewApplication {
+    /**
+     * Emit the operator-facing markdown audit of the SDK that the Render phase
+     * produced pages against.
+     *
+     * Call this exactly once. The markdown must follow the section layout
+     * dictated by the system prompt (Summary / What worked / What's awkward /
+     * What's missing / Pages that broke). The downstream operator reads it
+     * verbatim.
+     *
+     * @param props The completed feedback document plus a short narrative summary
+     *   for the event payload.
+     */
+    writeSdkFeedback(props: IAutoViewReviewApplication.IProps): void;
+}
+export declare namespace IAutoViewReviewApplication {
+    interface IProps {
+        /**
+         * One-sentence summary of the overall SDK quality assessment. Surfaced in
+         * the `autoViewReview` event so the operator can decide whether to read the
+         * full feedback document.
+         */
+        summary: string;
+        /**
+         * Complete markdown body of `wiki/sdk-feedback.md`. The orchestrator
+         * persists this verbatim.
+         */
+        markdown: string;
+    }
+}

package/lib/orchestrate/structures/IAutoViewReviewApplication.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAutoViewReviewApplication.js.map

package/lib/orchestrate/structures/IAutoViewReviewApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoViewReviewApplication.js","sourceRoot":"","sources":["../../../src/orchestrate/structures/IAutoViewReviewApplication.ts"],"names":[],"mappings":""}

package/lib/orchestrate/structures/IAutoViewSdkMap.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Structured output of the AutoView SDK Study phase.
+ *
+ * The agent populates this object by reading every TypeScript file under
+ * `src/api/` (plus the SDK's JSDoc comments) and inferring the resources,
+ * actors, and end-to-end journeys the SDK actually supports. The downstream
+ * Product Plan phase consumes this map verbatim to decide which screens belong
+ * in the frontend and which endpoints to omit.
+ *
+ * @author Samchon
+ */
+export interface IAutoViewSdkMap {
+    /** Coherent groups of endpoints organized around the same noun. */
+    resources: IAutoViewSdkMap.IResource[];
+    /** Roles the SDK serves (`customer`, `seller`, `administrator`, …). */
+    actors: IAutoViewSdkMap.IActor[];
+    /**
+     * SDK-level constraints worth surfacing to the Product Plan phase —
+     * pagination conventions, soft-delete semantics, auth scopes, idempotency
+     * keys, etc. One short sentence per entry.
+     */
+    notableConstraints: string[];
+}
+export declare namespace IAutoViewSdkMap {
+    interface IResource {
+        /** Short noun, e.g. `sales`, `orders`, `channels`, `categories`. */
+        name: string;
+        /**
+         * Dotted accessor path of the primary namespace, e.g.
+         * `shoppings.customers.sales`. When the resource is exposed under more than
+         * one actor namespace, list the customer-facing one here and call the
+         * others out in {@link notes}.
+         */
+        namespace: string;
+        /**
+         * One sentence in the operator's voice explaining _why_ the resource exists
+         * in the product. Not "CRUD on Sale" — "Browse and buy products that
+         * sellers have published".
+         */
+        purpose: string;
+        /**
+         * Subset of actor names from {@link IAutoViewSdkMap.actors} that interact
+         * with this resource.
+         */
+        actorsInvolved: string[];
+        /**
+         * Free-form notes for the Product Plan phase. Multi-actor exposure,
+         * pagination shape, soft-delete semantics, anything subtle. Empty string is
+         * fine.
+         */
+        notes: string;
+    }
+    interface IActor {
+        /** Lower-case role identifier (e.g. `customer`). */
+        name: string;
+        /**
+         * 1–5 end-to-end goals this actor accomplishes by composing several
+         * endpoints. Each entry is an arrow chain such as `sign up → browse catalog
+         * → add to cart → checkout`.
+         */
+        journeys: string[];
+    }
+}

package/lib/orchestrate/structures/IAutoViewSdkMap.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAutoViewSdkMap.js.map

package/lib/orchestrate/structures/IAutoViewSdkMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoViewSdkMap.js","sourceRoot":"","sources":["../../../src/orchestrate/structures/IAutoViewSdkMap.ts"],"names":[],"mappings":""}

package/lib/orchestrate/structures/IAutoViewSdkStudyApplication.d.ts

@@ -0,0 +1,37 @@
+import { IAutoViewSdkMap } from "./IAutoViewSdkMap";
+/**
+ * LLM function-calling surface for the AutoView SDK Study phase.
+ *
+ * The agent calls `buildSdkMap` exactly once with a completed
+ * {@link IAutoViewSdkMap} after analyzing the SDK source. The orchestrator then
+ * validates the map against the actual SDK shape before handing it to the
+ * Product Plan phase.
+ *
+ * @author Samchon
+ */
+export interface IAutoViewSdkStudyApplication {
+    /**
+     * Emit the structured domain map produced from reading the SDK.
+     *
+     * Call this exactly once. The map must list every coherent resource the SDK
+     * exposes (no silent drops), every actor the SDK actually serves (no invented
+     * roles), and any SDK-level constraints a frontend developer would need to
+     * know up-front.
+     *
+     * @param props The completed map plus a short narrative summary.
+     */
+    buildSdkMap(props: IAutoViewSdkStudyApplication.IProps): void;
+}
+export declare namespace IAutoViewSdkStudyApplication {
+    interface IProps {
+        /**
+         * 2–4 sentence narrative summary of the SDK in the operator's voice — the
+         * kind of paragraph an architect would write at the top of a design doc.
+         * Surfaced verbatim in the `autoViewSdkStudy` event so the operator can
+         * sanity-check the scope before authorizing the Product Plan phase.
+         */
+        summary: string;
+        /** The structured domain map. */
+        map: IAutoViewSdkMap;
+    }
+}

package/lib/orchestrate/structures/IAutoViewSdkStudyApplication.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAutoViewSdkStudyApplication.js.map

package/lib/orchestrate/structures/IAutoViewSdkStudyApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAutoViewSdkStudyApplication.js","sourceRoot":"","sources":["../../../src/orchestrate/structures/IAutoViewSdkStudyApplication.ts"],"names":[],"mappings":""}

package/lib/orchestrate/utils/HistoryMessage.d.ts

@@ -0,0 +1,10 @@
+import { IAgenticaHistoryJson } from "@agentica/core";
+type HistoryTextFactory<T> = {
+    (text: string): T;
+    (strings: TemplateStringsArray, ...values: unknown[]): T;
+};
+export declare const HistoryMessage: {
+    system: HistoryTextFactory<IAgenticaHistoryJson.ISystemMessage>;
+    assistant: HistoryTextFactory<IAgenticaHistoryJson.IAssistantMessage>;
+};
+export {};

package/lib/orchestrate/utils/HistoryMessage.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HistoryMessage = void 0;
+const utils_1 = require("../../utils");
+const uuid_1 = require("uuid");
+const trim = (input, ...values) => typeof input === "string"
+    ? utils_1.StringUtil.trim([input])
+    : utils_1.StringUtil.trim(input, ...values);
+const system = (input, ...values) => ({
+    id: (0, uuid_1.v7)(),
+    created_at: new Date().toISOString(),
+    type: "systemMessage",
+    text: trim(input, ...values),
+});
+const assistant = (input, ...values) => ({
+    id: (0, uuid_1.v7)(),
+    created_at: new Date().toISOString(),
+    type: "assistantMessage",
+    text: trim(input, ...values),
+});
+exports.HistoryMessage = {
+    system,
+    assistant,
+};
+//# sourceMappingURL=HistoryMessage.js.map

package/lib/orchestrate/utils/HistoryMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryMessage.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/HistoryMessage.ts"],"names":[],"mappings":";;;AACA,uCAAyC;AACzC,+BAA0B;AAO1B,MAAM,IAAI,GAAG,CACX,KAAoC,EACpC,GAAG,MAAiB,EACZ,EAAE,CACV,OAAO,KAAK,KAAK,QAAQ;IACvB,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAoC,CAAC;IAC7D,CAAC,CAAC,kBAAU,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,CAAC;AAExC,MAAM,MAAM,GAA4D,CACtE,KAAoC,EACpC,GAAG,MAAiB,EACpB,EAAE,CAAC,CAAC;IACJ,EAAE,EAAE,IAAA,SAAE,GAAE;IACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACpC,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,SAAS,GAA+D,CAC5E,KAAoC,EACpC,GAAG,MAAiB,EACpB,EAAE,CAAC,CAAC;IACJ,EAAE,EAAE,IAAA,SAAE,GAAE;IACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IACpC,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG;IAC5B,MAAM;IACN,SAAS;CACV,CAAC"}

package/lib/orchestrate/utils/auditFrontendRuntime.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Per-page runtime defect captured by the Playwright audit. `console` covers
+ * `console.error` calls the page made during boot; `pageerror` covers uncaught
+ * exceptions; `navigation` covers Playwright's own `page.goto` failure
+ * (timeout, net::ERR, etc.) so the orchestrator sees the page as broken even
+ * when the runtime did not get a chance to fire a console message.
+ */
+export interface IRuntimeAuditDiagnostic {
+    /** Screen path the agent emitted (e.g. `/cart`, `/sales/[id]`). */
+    pagePath: string;
+    /** Category of failure. */
+    type: "console" | "pageerror" | "navigation";
+    /** Human-readable message — kept short so the retry prompt stays focused. */
+    message: string;
+}
+export interface IAuditFrontendRuntimeResult {
+    /** Flat list of every diagnostic captured across all visited pages. */
+    diagnostics: IRuntimeAuditDiagnostic[];
+    /**
+     * Convenience map keyed by screen path → diagnostics on that page. Pages that
+     * booted without any console / pageerror / navigation issue are absent from
+     * the map (use {@link visited} for the full visit list).
+     */
+    byPage: Map<string, IRuntimeAuditDiagnostic[]>;
+    /**
+     * Screen paths that the audit attempted (`length === pages.length` on
+     * success).
+     */
+    visited: string[];
+    /** Markdown body for `wiki/runtime-audit.md`. */
+    markdown: string;
+    /** Wall-clock duration of the whole audit (install + boot + visits + cleanup). */
+    elapsedMs: number;
+}
+/**
+ * Boot the assembled frontend under `next dev`, launch a headless Chromium via
+ * Playwright, visit every screen the product plan declared, and return the
+ * per-page console / pageerror / navigation diagnostics. Used by the
+ * orchestrator as Phase 6 (runtime audit) — the layer above `tsc --noEmit` that
+ * catches errors typecheck cannot see (`obj?.array.method(...)`
+ * undefined-access patterns, missing client-only guards, react render
+ * crashes).
+ *
+ * Operates in `NEXT_PUBLIC_API_SIMULATE=true` so the audit does not require a
+ * live backend — the SDK serves typia-random fixture data and pages exercise
+ * their real render paths. Live-backend variants can be added later by
+ * threading the host through.
+ *
+ * Throws on infrastructure failure (`npm install` crashed, port allocation
+ * failed, Chromium download blocked). Runtime errors on the pages themselves
+ * are returned as data; the whole point of this gate is to surface them.
+ */
+export declare function auditFrontendRuntime(files: Record<string, string>, pages: string[]): Promise<IAuditFrontendRuntimeResult>;