@antelopejs/dms-ai 0.1.5 → 0.2.0

package/sidecar/dist/state/types.d.ts

@@ -1,14 +1,46 @@
-export declare const STORED_MESSAGE_ROLES: readonly ["user", "assistant", "tool_use", "tool_result", "permission", "error"];
-export type StoredMessageRole = (typeof STORED_MESSAGE_ROLES)[number];
-export declare const STORED_MESSAGE_STATUSES: readonly ["success", "error"];
-export type StoredMessageStatus = (typeof STORED_MESSAGE_STATUSES)[number];
-export declare const STORED_PERMISSION_DECISIONS: readonly ["approved", "denied"];
-export type StoredPermissionDecision = (typeof STORED_PERMISSION_DECISIONS)[number];
-export interface StoredAttachmentMeta {
+import type { AllowedBy, ChangeFileStatus, ChangeSetState, FullAutoDuration, PermissionKind, ToolOutcome, TypecheckOutcome } from "../constants/audit.js";
+import type { ChatMode, GenerationMode } from "./settings-types.js";
+declare const STORED_MESSAGE_ROLES: readonly ["user", "assistant", "tool_use", "tool_result", "permission", "error", "notice", "change_set", "question_answer"];
+type StoredMessageRole = (typeof STORED_MESSAGE_ROLES)[number];
+declare const STORED_MESSAGE_STATUSES: readonly ["success", "error"];
+type StoredMessageStatus = (typeof STORED_MESSAGE_STATUSES)[number];
+declare const STORED_PERMISSION_DECISIONS: readonly ["approved", "denied"];
+type StoredPermissionDecision = (typeof STORED_PERMISSION_DECISIONS)[number];
+interface StoredAttachmentMeta {
     name: string;
     mimeType: string;
     size: number;
 }
+export interface AutoFixNotice {
+    kind: "autofix";
+    attempt: number;
+    maxAttempts: number;
+    errors: string[];
+    timestampMs: number;
+}
+export interface PermissionExpiredNotice {
+    kind: "permission_expired";
+    toolName: string;
+    summary: string;
+    timestampMs: number;
+}
+export interface QuestionSkippedNotice {
+    kind: "question_skipped";
+    header: string;
+    timestampMs: number;
+}
+export interface FullAutoEndedNotice {
+    kind: "full_auto_ended";
+    timestampMs: number;
+}
+export type Notice = AutoFixNotice | PermissionExpiredNotice | QuestionSkippedNotice | FullAutoEndedNotice;
+export interface QuestionAnswerRecord {
+    header: string;
+    question: string;
+    answer: string | null;
+    skipped: boolean;
+    isCustom: boolean;
+}
 export interface StoredMessage {
     role: StoredMessageRole;
     content: string;
@@ -19,6 +51,21 @@ export interface StoredMessage {
     attachments?: StoredAttachmentMeta[];
     isRetryable?: boolean;
     timestampMs: number;
+    outcome?: ToolOutcome;
+    allowedBy?: AllowedBy;
+    changeSetId?: string;
+    notice?: Notice;
+    answers?: QuestionAnswerRecord[];
+    isAutoFix?: boolean;
+    requestId?: string;
+    kind?: PermissionKind;
+    alwaysAsk?: boolean;
+    summary?: string;
+    args?: unknown;
+    requestedAtMs?: number;
+    expiresAtMs?: number;
+    feedback?: string;
+    decidedBy?: string;
 }
 export declare const PROVIDER_NAMES: readonly ["claude", "codex"];
 export type ProviderName = (typeof PROVIDER_NAMES)[number];
@@ -29,20 +76,79 @@ export interface TokenUsage {
     totalTokens: number;
 }
 export declare const EMPTY_TOKEN_USAGE: TokenUsage;
+interface UsageEntry extends TokenUsage {
+    timestampMs: number;
+}
 export interface StoredConversation {
     messages: StoredMessage[];
     createdAtMs: number;
     updatedAtMs: number;
     provider?: ProviderName;
     tokenUsage?: TokenUsage;
+    usageLog?: UsageEntry[];
+    mode?: ChatMode;
+    generationMode?: GenerationMode;
 }
 export interface StoredState {
     conversations: Record<string, StoredConversation>;
 }
-export interface ConversationSummary {
+export interface StoredConversationSummary {
     id: string;
     title: string;
     createdAtMs: number;
     updatedAtMs: number;
     messageCount: number;
+    provider?: ProviderName;
+    totalTokens: number;
+}
+export interface ConversationSummary extends StoredConversationSummary {
+    filesChanged: number;
+    filesUndone: number;
+    isRunning: boolean;
+    pendingApprovals: number;
+    pendingQuestions: number;
+    generationMode: GenerationMode;
+}
+export interface FullAutoState {
+    duration: FullAutoDuration;
+    untilMs?: number;
+}
+export interface ChangeSetFile {
+    path: string;
+    status: ChangeFileStatus;
+    added: number;
+    removed: number;
+}
+export interface ChangeSetSummary {
+    id: string;
+    number: number;
+    conversationId: string;
+    title: string;
+    createdAtMs: number;
+    agent: ProviderName;
+    scope: GenerationMode;
+    isAutoFix: boolean;
+    overlapped: boolean;
+    files: ChangeSetFile[];
+    added: number;
+    removed: number;
+    typecheck: TypecheckOutcome;
+    state: ChangeSetState;
+    stateChangedAtMs?: number;
+    stateChangedBy?: string;
+    askedBy?: string;
+    approvalsNeeded: number;
+    builderOps: number;
+}
+interface ChangeSetStateChange {
+    state: ChangeSetState;
+    atMs: number;
+    by?: string;
+}
+export interface ChangeSetRecord extends ChangeSetSummary {
+    beforeTree: string;
+    afterTree: string;
+    pagePath?: string;
+    stateLog?: ChangeSetStateChange[];
 }
+export {};

package/sidecar/dist/state/types.js

@@ -1,13 +1,16 @@
-export const STORED_MESSAGE_ROLES = [
+const STORED_MESSAGE_ROLES = [
     "user",
     "assistant",
     "tool_use",
     "tool_result",
     "permission",
     "error",
+    "notice",
+    "change_set",
+    "question_answer",
 ];
-export const STORED_MESSAGE_STATUSES = ["success", "error"];
-export const STORED_PERMISSION_DECISIONS = ["approved", "denied"];
+const STORED_MESSAGE_STATUSES = ["success", "error"];
+const STORED_PERMISSION_DECISIONS = ["approved", "denied"];
 export const PROVIDER_NAMES = ["claude", "codex"];
 export const DEFAULT_PROVIDER_NAME = PROVIDER_NAMES[0];
 export const EMPTY_TOKEN_USAGE = {

package/sidecar/dist/state/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,MAAM;IACN,WAAW;IACX,UAAU;IACV,aAAa;IAIb,YAAY;IACZ,OAAO;CACC,CAAC;AAIX,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC;AAMrE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAU,CAAC;AA2B3E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,qBAAqB,GAAiB,cAAc,CAAC,CAAC,CAAC,CAAC;AAUrE,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;CACf,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"AAWA,MAAM,oBAAoB,GAAG;IAC3B,MAAM;IACN,WAAW;IACX,UAAU;IACV,aAAa;IAIb,YAAY;IACZ,OAAO;IAIP,QAAQ;IAER,YAAY;IAEZ,iBAAiB;CACT,CAAC;AAIX,MAAM,uBAAuB,GAAG,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC;AAM9D,MAAM,2BAA2B,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAU,CAAC;AAmFpE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAG3D,MAAM,CAAC,MAAM,qBAAqB,GAAiB,cAAc,CAAC,CAAC,CAAC,CAAC;AAUrE,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;CACf,CAAC"}

package/skills/dms-builder-safe/REFERENCE.md

@@ -107,5 +107,5 @@ GET wrapper isn't the `return { value: await model.m(...) }` shape) or `unparsea
 model method isn't a chain any template accepts — hand-written differently, edited out of the
 grammar, or emitted by a newer builder). `BuilderConfigureQuery` refuses an opaque query with
 `opaque_target`, but it stays visible and `BuilderRemoveQuery` still works: the builder can
-always remove what it cannot edit. To reshape an opaque query, edit it in vibe mode — or bring
+always remove what it cannot edit. To reshape an opaque query, edit it in Code mode — or bring
 its body back within the chain grammar and the builder picks it up again.

package/skills/dms-builder-safe/SKILL.md

@@ -33,7 +33,7 @@ success it returns the file changes; on `typecheck_failed` **nothing is written*
   Never pass a raw `$expr`; safe mode refuses it.
 - Config fields the catalog marks `x-component` hold a nested component (e.g. a
   ChartCard's `chart`), which safe mode cannot construct — there is no `$expr` escape
-  hatch. Treat them like `opaque_target`: explain and ask to switch to Vibe mode.
+  hatch. Treat them like `opaque_target`: explain and ask to switch to Code mode.
 - To name a builder-generated resource class inside config — e.g. a relation column's
   `dataApiController` — pass a **reference value**
   `{ $ref: { resource: "<ref>", as?: "dataApi" | "table" | "model" } }` (default `as`
@@ -42,9 +42,13 @@ success it returns the file changes; on `typecheck_failed` **nothing is written*
 
 ## Workflow
 
-1. **Discover the catalog first.** `BuilderCatalog` lists the valid block `type`s
-   (Grid, GridRow, KpiCard, Form, Tab, Tree, ChartCard, TableView, …), their config
-   schemas, and the DataTypes. Only use types it lists.
+1. **Discover the catalog first.** `BuilderCatalog` with no arguments returns a
+   compact index: every valid block `type` (Grid, GridRow, KpiCard, Form, Tab,
+   ChartCard, TableView, …) with a one-line description and its `container` /
+   `controllerArg` flags, every DataType id with its config keys, and
+   `reservedFieldNames`. Only use types it lists. Then call it again with
+   `blocks: ["TableView", …]` and/or `dataTypes: ["select", …]` for the full config
+   schema of just the entries you will use — never ask for everything at once.
 2. **Read before you write.** `BuilderListPages` to find a page/category;
    `BuilderPageStructure <pageRef>` for the block tree, `editable` flags, and
    `version` hash. Model new blocks on an existing page.
@@ -100,15 +104,16 @@ template catalog, route-bound params, opaque read-back, and the full query workf
   or doesn't implement the op (`request_failed` with `HTTP 400` = the host answered
   `unknown_op`). Explain the limitation; don't retry.
 - `opaque_target` / `unsupported` → **safe mode cannot do this**. Explain the
-  limitation and ask permission to switch to **Vibe mode** for that one step; do not
-  force it. After any vibe-mode excursion, call `BuilderRefresh` (optionally scoped
+  limitation and ask permission to switch to **Code mode** for that one step; do not
+  force it. After any Code mode excursion, call `BuilderRefresh` (optionally scoped
   to the page) so the builder's source index reconciles with disk before further
   safe-mode ops.
 - `stale` → the page changed under you; re-read with `BuilderPageStructure`, retry.
 
 ## Guardrails
 
-- Always `BuilderCatalog` before adding blocks; use only listed types + config keys.
+- Always `BuilderCatalog` before adding blocks, then fetch the full schema of each
+  type you use (`blocks: [...]`); use only listed types + config keys.
   Likewise `BuilderQueryTemplates` before adding a query.
 - Block/child names are mandatory and unique among siblings.
 - A card showing an aggregate needs a query behind it — don't point a `fetchUrl` at a

package/dist/routes/proxy.d.ts

@@ -1,4 +0,0 @@
-export type QueryParams = Record<string, string | undefined>;
-export declare function buildQuery(params: QueryParams): string;
-export declare function sidecarGet<T>(path: string, fallback: T): Promise<T>;
-export declare function sidecarPut<T>(path: string, body: unknown, fallback: T): Promise<T>;

package/dist/routes/proxy.js

@@ -1,55 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildQuery = buildQuery;
-exports.sidecarGet = sidecarGet;
-exports.sidecarPut = sidecarPut;
-const spawn_sidecar_1 = require("../lifecycle/spawn-sidecar");
-const SIDECAR_HOST = "http://127.0.0.1";
-function buildQuery(params) {
-    const sp = new URLSearchParams();
-    for (const [key, value] of Object.entries(params)) {
-        if (value !== undefined && value !== "")
-            sp.set(key, value);
-    }
-    const serialized = sp.toString();
-    return serialized ? `?${serialized}` : "";
-}
-async function sidecarFetch(path, init) {
-    await (0, spawn_sidecar_1.ensureSidecarRunning)();
-    const port = (0, spawn_sidecar_1.getSidecarPort)();
-    if (port === null)
-        throw new Error("dms-ai sidecar is not running");
-    const token = (0, spawn_sidecar_1.getSidecarClientToken)();
-    if (!token)
-        throw new Error("dms-ai sidecar client credential is missing");
-    const headers = new Headers(init?.headers);
-    headers.set("Authorization", `Bearer ${token}`);
-    const res = await fetch(`${SIDECAR_HOST}:${port}${path}`, {
-        ...init,
-        headers,
-    });
-    if (!res.ok)
-        throw new Error(`dms-ai sidecar responded ${res.status}`);
-    return res.json();
-}
-async function sidecarGet(path, fallback) {
-    try {
-        return (await sidecarFetch(path));
-    }
-    catch {
-        return fallback;
-    }
-}
-async function sidecarPut(path, body, fallback) {
-    try {
-        return (await sidecarFetch(path, {
-            method: "PUT",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(body),
-        }));
-    }
-    catch {
-        return fallback;
-    }
-}
-//# sourceMappingURL=proxy.js.map

package/dist/routes/proxy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/routes/proxy.ts"],"names":[],"mappings":";;AAUA,gCAOC;AAyBD,gCAMC;AAED,gCAcC;AAhED,8DAIoC;AAEpC,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAIxC,SAAgB,UAAU,CAAC,MAAmB;IAC5C,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IACD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,IAAY,EACZ,IAAkB;IAElB,MAAM,IAAA,oCAAoB,GAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAA,8BAAc,GAAE,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,IAAA,qCAAqB,GAAE,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,IAAI,IAAI,GAAG,IAAI,EAAE,EAAE;QACxD,GAAG,IAAI;QACP,OAAO;KACR,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC;AAMM,KAAK,UAAU,UAAU,CAAI,IAAY,EAAE,QAAW;IAC3D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAM,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,IAAa,EACb,QAAW;IAEX,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE;YAC/B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAM,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}