@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/result-view.js

@@ -1,6 +1,993 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runResultViewCommand=D;const x=require("../shared/agent-text"),h=require("../shared/errors"),E=require("./inspect-cycles"),g=require("./session-workspace");function D(t,e,r){if(r!==void 0)return M(t,r);const n=e.find(u=>!u.startsWith("--"));if(!n)throw new h.CliError("VIEW_HANDLE_REQUIRED","Usage: aib view aib:res_<id>");const i=V(n),s=T(e.slice(1));if(i.short)return L((0,g.readSessionResultViewJson)(t,i.id),s,n);if(i.kind==="cycles")return(0,E.buildCyclesViewResponse)((0,g.readSessionResultJson)(t,i.kind,i.id),{...s.detail!==void 0?{detail:b(s.detail)}:{},...s.offset!==void 0?{offset:s.offset}:{},...s.limit!==void 0?{limit:s.limit}:{},...s.index!==void 0?{index:s.index}:{},...s.kind!==void 0?{kind:A(s.kind)}:{},resultHandle:n});const d={ok:!1,code:"UNSUPPORTED_RESULT_VIEW",error:`aib view does not support result kind: ${i.kind}`};return(0,x.attachAgentText)(d,`unsupported result view: ${i.kind}`)}function M(t,e){const r=Array.isArray(e.views),n=Array.isArray(e.views)?e.views:[],i=r?n.filter(m):m(e.view)?[e.view]:m(e)?[e]:[];if(i.length===0)throw new h.CliError("VIEW_HANDLE_REQUIRED","view expects a handle.");const s=i.map((u,f)=>{try{return N(t,u)}catch(c){if(!r||i.length===1)throw c;return{...(0,h.errorPayload)(c),index:f}}});if(s.length===1)return s[0];const d=s.filter(u=>m(u)&&u.ok===!1).length;return(0,x.attachAgentText)({ok:d===0,...d>0?{batchOk:!1,failedCount:d}:{},results:s},s.map(u=>{if(!m(u))return"";const f=(0,x.readAgentText)(u);return typeof f=="string"?f.trimEnd():""}).filter(u=>u!=="").join(`
-
-`))}function N(t,e){const r=o(e.handle)??o(e.from)??"";if(!r)throw new h.CliError("VIEW_HANDLE_REQUIRED","view expects a handle.");const n=V(r),i={...o(e.detail)!==void 0?{detail:o(e.detail)}:{},...p(e.offset)!==void 0?{offset:p(e.offset)}:{},...p(e.limit)!==void 0?{limit:p(e.limit)}:{},...p(e.index)!==void 0?{index:p(e.index)}:{},...o(e.kind)!==void 0?{kind:o(e.kind)}:{},...k(e.only).length>0?{only:k(e.only)}:{},...k(e.except).length>0?{except:k(e.except)}:{}};return n.short?L((0,g.readSessionResultViewJson)(t,n.id),i,r):n.kind==="cycles"?(0,E.buildCyclesViewResponse)((0,g.readSessionResultJson)(t,n.kind,n.id),{...i.detail!==void 0?{detail:b(i.detail)}:{},...i.offset!==void 0?{offset:i.offset}:{},...i.limit!==void 0?{limit:i.limit}:{},...i.index!==void 0?{index:i.index}:{},...i.kind!==void 0?{kind:A(i.kind)}:{},resultHandle:r}):(0,x.attachAgentText)({ok:!1,code:"UNSUPPORTED_RESULT_VIEW",error:`aib view does not support result kind: ${n.kind}`},`unsupported result view: ${n.kind}`)}function V(t){if(/^aib:res_[A-Za-z0-9_-]+$/.test(t))return{kind:"view",id:t.slice(4),short:!0};const e=t.split(":");if(e.length!==4||e[0]!=="aib"||e[1]!=="result"||!e[2]||!e[3])throw new h.CliError("INVALID_RESULT_HANDLE",`Invalid result handle: ${t}`,{expected:"aib:res_<id>"});return{kind:e[2],id:e[3],short:!1}}function T(t){const e={},r=I(t,"--detail"),n=_(t,"--offset"),i=_(t,"--limit"),s=_(t,"--index"),d=I(t,"--kind"),u=$(t,"--only").flatMap(w),f=$(t,"--except").flatMap(w);return r!==void 0&&(e.detail=r),n!==void 0&&(e.offset=n),i!==void 0&&(e.limit=i),s!==void 0&&(e.index=s),d!==void 0&&(e.kind=d),u.length>0&&(e.only=u),f.length>0&&(e.except=f),e}function L(t,e,r){const n=o(t.kind);return t.op==="cycles"?(0,E.buildCyclesViewResponse)(t,{...e.detail!==void 0?{detail:b(e.detail)}:{},...e.offset!==void 0?{offset:e.offset}:{},...e.limit!==void 0?{limit:e.limit}:{},...e.index!==void 0?{index:e.index}:{},...e.kind!==void 0?{kind:A(e.kind)}:{},resultHandle:r}):n==="code"?W(t,e,r):n==="members"||n==="duplicates"||n==="usages"?U(t,e,r,n):(0,x.attachAgentText)({ok:!1,code:"UNSUPPORTED_RESULT_VIEW",error:`aib view does not support result kind: ${n??"unknown"}`},`unsupported result view: ${n??"unknown"}`)}function U(t,e,r,n){const i=Array.isArray(t.items)?t.items.filter(m):[],s=C(i,e,y=>[o(y.name),o(y.text)?.split(/\s+/)[0]]),d=Math.max(0,e.offset??0),u=s.length||1,f=Math.max(1,e.limit??u),c=s.slice(d,d+f),l=Math.max(0,s.length-d-c.length),a={ok:!0,op:"view",handle:r,kind:n,source:o(t.source)??"inspect",...o(t.file)!==void 0?{file:o(t.file)}:{},...o(t.entity)!==void 0?{entity:o(t.entity)}:{},...o(t.target)!==void 0?{target:o(t.target)}:{},...o(t.detail)!==void 0?{detail:o(t.detail)}:{},items:c,offset:d,limit:f,...l>0?{hidden:l}:{}};return(0,x.attachAgentText)(a,P(a))}function W(t,e,r){const n=Array.isArray(t.items)?t.items.filter(m):[],i=C(n,e,a=>[o(a.entity),o(a.name)]),s=Math.max(0,e.offset??0),d=i.length||1,u=Math.max(1,e.limit??d),f=i.slice(s,s+u),c=Math.max(0,i.length-s-f.length),l={ok:!0,op:"view",handle:r,kind:"code",source:o(t.source)??"inspect",items:f,offset:s,limit:u,...c>0?{hidden:c}:{},...f.length===0&&n.length>0&&H(e)?{noMatches:!0}:{}};return(0,x.attachAgentText)(l,O(l))}function O(t){const e=[],r=Array.isArray(t.items)?t.items.filter(m):[];if(r.length===0&&t.noMatches===!0)return e.push("no hidden code matched view filters"),e.join(`
-`);let n="";for(const s of r){const d=o(s.file)??"";d&&d!==n&&(e.length>0&&e.push(""),e.push(`// ${d}`),n=d);const u=o(s.entity)??"",f=o(s.meta)??o(s.rangeMeta)??"",c=[u,f].filter(a=>a!=="").join(" ");c&&e.push(`// ${c}`);const l=o(s.code);l&&e.push(l.trimEnd())}const i=p(t.hidden)??0;return i>0&&e.push(`+ ${i} more hidden code blocks`),e.join(`
-`)}function P(t){const e=[],r=o(t.file),n=o(t.target),i=o(t.kind)??"",s=o(t.detail);r?e.push(`// ${r}`):i==="usages"?e.push(s?`usages ${s}`:"usages"):n&&e.push(`duplicates ${n}`);const d=o(t.entity);d&&e.push(`// ${d}:`);const u=Array.isArray(t.items)?t.items.filter(m):[];if(i==="usages")for(const[c,l]of j(u,a=>o(a.name)??"")){c&&e.push(`${c}:`);for(const a of l){const y=o(a.text);y&&e.push(y.trimEnd())}}else for(const c of u){const l=o(c.text);l&&e.push(l.trimEnd())}const f=p(t.hidden)??0;return f>0&&e.push(`+ ${f} more hidden ${i==="members"?"members":i==="usages"?"usages":"items"}`),e.join(`
-`)}function j(t,e){const r=new Map;for(const n of t){const i=e(n),s=r.get(i)??[];s.push(n),r.set(i,s)}return Array.from(r.entries())}function b(t){if(t==="summary"||t==="sum")return"summary";if(t==="imports"||t==="files")return t;throw new h.CliError("INVALID_CYCLES_DETAIL","aib view cycles --detail expects summary, imports, or files.")}function A(t){if(t==="runtime"||t==="type-only"||t==="mixed")return t;throw new h.CliError("INVALID_CYCLES_KIND","aib view cycles --kind expects runtime, type-only, or mixed.")}function I(t,e){const r=t.indexOf(e),n=r>=0?t[r+1]:void 0;return n&&!n.startsWith("--")?n:void 0}function $(t,e){const r=[];for(let n=0;n<t.length;n+=1){if(t[n]!==e)continue;const i=t[n+1];i&&!i.startsWith("--")&&r.push(i)}return r}function _(t,e){const r=I(t,e);if(r===void 0)return;const n=Number(r),i=e==="--offset"?0:1;if(!Number.isInteger(n)||n<i)throw new h.CliError("INVALID_VIEW_OPTION",`${e} expects ${i===0?"a non-negative":"a positive"} integer.`);return n}function m(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}function o(t){return typeof t=="string"&&t!==""?t:void 0}function p(t){return typeof t=="number"&&Number.isFinite(t)?t:void 0}function k(t){return typeof t=="string"&&t!==""?w(t):Array.isArray(t)?t.filter(e=>typeof e=="string"&&e!=="").flatMap(w):[]}function C(t,e,r){const n=e.only??[],i=e.except??[],s=n.length>0?t.filter(d=>S(r(d),n)):t;return i.length===0?s:s.filter(d=>!S(r(d),i))}function H(t){return(t.only?.length??0)>0||(t.except?.length??0)>0}function S(t,e){return t.some(r=>r!==void 0&&e.some(n=>F(r,n)))}function F(t,e){if(t===e)return!0;const r=t.split(".").pop()??t,n=e.split(".").pop()??e;return r===n&&!e.includes(".")}function w(t){const e=t.trim();return(J(e)??R(e)).flatMap(q)}function q(t){const e=t.trim(),r=e.match(/^(.+)\.\{(.+)\}$/);if(r){const n=r[1],i=r[2];if(n&&i)return R(i).map(s=>`${n}.${s}`)}return e?[e]:[]}function J(t){if(!t.startsWith("[")||!t.endsWith("]"))return null;const e=t.slice(1,-1).trim();return e?R(e):[]}function R(t){const e=[];let r="",n=0;for(const i of t){if(i==="{"?n+=1:i==="}"&&n>0&&(n-=1),i===","&&n===0){r.trim()&&e.push(r.trim()),r="";continue}r+=i}return r.trim()&&e.push(r.trim()),e}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runResultViewCommand = runResultViewCommand;
+const path = __importStar(require("node:path"));
+const agent_dx_1 = require("../agent-dx/agent-dx");
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const declaration_format_1 = require("./declaration-format");
+const inspect_cycles_1 = require("./inspect-cycles");
+const object_pack_command_1 = require("./object-pack-command");
+const session_workspace_1 = require("./session-workspace");
+function runResultViewCommand(cwd, restArgs, stdinPayload) {
+    const agentDxSignals = collectViewAgentDxSignals(restArgs);
+    if (stdinPayload !== undefined) {
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, runResultViewPayload(cwd, stdinPayload), agentDxSignals);
+    }
+    const handle = restArgs.find((arg) => !arg.startsWith("--"));
+    if (!handle) {
+        throw new errors_1.CliError("VIEW_HANDLE_REQUIRED", "Usage: aib view aib:res_<id>");
+    }
+    const parsed = parseResultHandle(handle);
+    const options = parseViewOptions(restArgs.slice(1));
+    if (parsed.short) {
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, buildGenericViewResponse(cwd, (0, session_workspace_1.readSessionResultViewJson)(cwd, parsed.id), options, handle), agentDxSignals);
+    }
+    if (parsed.kind === "cycles") {
+        return (0, agent_dx_1.applyAgentDxSignals)(cwd, (0, inspect_cycles_1.buildCyclesViewResponse)((0, session_workspace_1.readSessionResultJson)(cwd, parsed.kind, parsed.id), {
+            ...(options.detail !== undefined ? { detail: readCyclesDetail(options.detail) } : {}),
+            ...(options.offset !== undefined ? { offset: options.offset } : {}),
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+            ...(options.index !== undefined ? { index: options.index } : {}),
+            ...(options.kind !== undefined ? { kind: readCyclesKind(options.kind) } : {}),
+            resultHandle: handle
+        }), agentDxSignals);
+    }
+    const response = {
+        ok: false,
+        code: "UNSUPPORTED_RESULT_VIEW",
+        error: `aib view does not support result kind: ${parsed.kind}`
+    };
+    return (0, agent_dx_1.applyAgentDxSignals)(cwd, (0, agent_text_1.attachAgentText)(response, `unsupported result view: ${parsed.kind}`), agentDxSignals);
+}
+function runResultViewPayload(cwd, payload) {
+    const batchInput = Array.isArray(payload.views);
+    const rawViews = Array.isArray(payload.views) ? payload.views : [];
+    const views = batchInput
+        ? rawViews.filter(isObject)
+        : isObject(payload.view)
+            ? [payload.view]
+            : isObject(payload)
+                ? [payload]
+                : [];
+    if (views.length === 0) {
+        throw new errors_1.CliError("VIEW_HANDLE_REQUIRED", "view expects a handle.");
+    }
+    const results = views.map((view, index) => {
+        try {
+            return runSingleResultView(cwd, view);
+        }
+        catch (error) {
+            if (!batchInput || views.length === 1) {
+                throw error;
+            }
+            const failed = (0, errors_1.errorPayload)(error);
+            return {
+                ...failed,
+                index
+            };
+        }
+    });
+    if (results.length === 1) {
+        return results[0];
+    }
+    const failedCount = results.filter((result) => isObject(result) && result.ok === false).length;
+    return (0, agent_text_1.attachAgentText)({
+        ok: failedCount === 0,
+        ...(failedCount > 0 ? { batchOk: false, failedCount } : {}),
+        results
+    }, results
+        .map((result) => {
+        if (!isObject(result)) {
+            return "";
+        }
+        const text = (0, agent_text_1.readAgentText)(result);
+        return typeof text === "string" ? text.trimEnd() : "";
+    })
+        .filter((text) => text !== "")
+        .join("\n\n"));
+}
+function runSingleResultView(cwd, view) {
+    const handle = readString(view.handle) ?? readString(view.from) ?? "";
+    if (!handle) {
+        throw new errors_1.CliError("VIEW_HANDLE_REQUIRED", "view expects a handle.");
+    }
+    const parsed = parseResultHandle(handle);
+    const options = {
+        ...(readString(view.detail) !== undefined ? { detail: readString(view.detail) } : {}),
+        ...(readNumber(view.offset) !== undefined ? { offset: readNumber(view.offset) } : {}),
+        ...(readNumber(view.limit) !== undefined ? { limit: readNumber(view.limit) } : {}),
+        ...(readNumber(view.index) !== undefined ? { index: readNumber(view.index) } : {}),
+        ...(readString(view.kind) !== undefined ? { kind: readString(view.kind) } : {}),
+        ...(readStringList(view.only).length > 0 ? { only: readStringList(view.only) } : {}),
+        ...(readStringList(view.except).length > 0 ? { except: readStringList(view.except) } : {})
+    };
+    if (parsed.short) {
+        return buildGenericViewResponse(cwd, (0, session_workspace_1.readSessionResultViewJson)(cwd, parsed.id), options, handle);
+    }
+    if (parsed.kind === "cycles") {
+        return (0, inspect_cycles_1.buildCyclesViewResponse)((0, session_workspace_1.readSessionResultJson)(cwd, parsed.kind, parsed.id), {
+            ...(options.detail !== undefined ? { detail: readCyclesDetail(options.detail) } : {}),
+            ...(options.offset !== undefined ? { offset: options.offset } : {}),
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+            ...(options.index !== undefined ? { index: options.index } : {}),
+            ...(options.kind !== undefined ? { kind: readCyclesKind(options.kind) } : {}),
+            resultHandle: handle
+        });
+    }
+    return (0, agent_text_1.attachAgentText)({
+        ok: false,
+        code: "UNSUPPORTED_RESULT_VIEW",
+        error: `aib view does not support result kind: ${parsed.kind}`
+    }, `unsupported result view: ${parsed.kind}`);
+}
+function parseResultHandle(handle) {
+    if (/^aib:res_[A-Za-z0-9_-]+$/.test(handle)) {
+        return {
+            kind: "view",
+            id: handle.slice("aib:".length),
+            short: true
+        };
+    }
+    const parts = handle.split(":");
+    if (parts.length !== 4 || parts[0] !== "aib" || parts[1] !== "result" || !parts[2] || !parts[3]) {
+        throw new errors_1.CliError("INVALID_RESULT_HANDLE", `Invalid result handle: ${handle}`, {
+            expected: "aib:res_<id>"
+        });
+    }
+    return {
+        kind: parts[2],
+        id: parts[3],
+        short: false
+    };
+}
+function parseViewOptions(args) {
+    const options = {};
+    const detail = readFlagValue(args, "--detail");
+    const offset = readOptionalIntegerFlag(args, "--offset");
+    const limit = readOptionalIntegerFlag(args, "--limit");
+    const index = readOptionalIntegerFlag(args, "--index");
+    const kind = readFlagValue(args, "--kind");
+    const only = readFlagValues(args, "--only").flatMap(expandSelectorInput);
+    const except = readFlagValues(args, "--except").flatMap(expandSelectorInput);
+    if (detail !== undefined) {
+        options.detail = detail;
+    }
+    if (offset !== undefined) {
+        options.offset = offset;
+    }
+    if (limit !== undefined) {
+        options.limit = limit;
+    }
+    if (index !== undefined) {
+        options.index = index;
+    }
+    if (kind !== undefined) {
+        options.kind = kind;
+    }
+    if (only.length > 0) {
+        options.only = only;
+    }
+    if (except.length > 0) {
+        options.except = except;
+    }
+    return options;
+}
+const VIEW_KNOWN_FLAGS = new Set([
+    "--detail",
+    "--dsl",
+    "--except",
+    "--force-dsl",
+    "--from",
+    "--from-dsl",
+    "--from-json",
+    "--index",
+    "--kind",
+    "--limit",
+    "--offset",
+    "--only",
+    "--stdin",
+    "--stdin-format"
+]);
+const VIEW_VALUE_FLAGS = new Set([
+    "--detail",
+    "--except",
+    "--from",
+    "--from-dsl",
+    "--from-json",
+    "--index",
+    "--kind",
+    "--limit",
+    "--offset",
+    "--only",
+    "--stdin-format"
+]);
+function collectViewAgentDxSignals(args) {
+    const signal = (0, agent_dx_1.collectUnknownFlagSignal)({
+        command: "view",
+        args,
+        knownFlags: VIEW_KNOWN_FLAGS,
+        valueFlags: VIEW_VALUE_FLAGS,
+        helpRefs: [{ topic: "view", reason: "unknownFlag", priority: 1, mode: "command" }]
+    });
+    return signal ? [signal] : [];
+}
+function buildGenericViewResponse(cwd, artifact, options, handle) {
+    const kind = readString(artifact.kind);
+    if (artifact.op === "cycles") {
+        return (0, inspect_cycles_1.buildCyclesViewResponse)(artifact, {
+            ...(options.detail !== undefined ? { detail: readCyclesDetail(options.detail) } : {}),
+            ...(options.offset !== undefined ? { offset: options.offset } : {}),
+            ...(options.limit !== undefined ? { limit: options.limit } : {}),
+            ...(options.index !== undefined ? { index: options.index } : {}),
+            ...(options.kind !== undefined ? { kind: readCyclesKind(options.kind) } : {}),
+            resultHandle: handle
+        });
+    }
+    if (kind === "code") {
+        return buildCodeViewResponse(artifact, options, handle);
+    }
+    if (kind === "members" || kind === "duplicates" || kind === "usages") {
+        return buildListViewResponse(artifact, options, handle, kind);
+    }
+    if (kind === "declarationMutation") {
+        return buildDeclarationMutationViewResponse(cwd, artifact, handle);
+    }
+    if (kind === "declarationCleanup") {
+        return buildDeclarationCleanupViewResponse(cwd, artifact, handle);
+    }
+    if (kind === "mutationFiles") {
+        return buildMutationFilesViewResponse(cwd, artifact, options, handle);
+    }
+    if (kind === "importsNormalize") {
+        return buildImportsNormalizeViewResponse(cwd, artifact, options, handle);
+    }
+    if (kind === "objectPack") {
+        return (0, object_pack_command_1.buildObjectPackViewResponse)(cwd, artifact, handle);
+    }
+    if (kind === "exportsStarExpandBatch" || kind === "exportsStarExpandWrite" || kind === "exportsStarExpandWriteBatch" || kind === "exportsStarCollapseBatch" || kind === "exportsStarCollapseWrite" || kind === "exportsStarCollapseWriteBatch") {
+        return buildExportsStarViewResponse(artifact, handle, kind);
+    }
+    return (0, agent_text_1.attachAgentText)({
+        ok: false,
+        code: "UNSUPPORTED_RESULT_VIEW",
+        error: `aib view does not support result kind: ${kind ?? "unknown"}`
+    }, `unsupported result view: ${kind ?? "unknown"}`);
+}
+function buildExportsStarViewResponse(artifact, handle, kind) {
+    const barrels = kind === "exportsStarExpandBatch" || kind === "exportsStarCollapseBatch"
+        ? readObjectList(artifact.barrels)
+        : kind === "exportsStarExpandWriteBatch" || kind === "exportsStarCollapseWriteBatch"
+            ? readObjectList(artifact.results).flatMap((result) => readObjectList(result.results))
+            : readObjectList(artifact.results);
+    const plannedCount = barrels.reduce((sum, barrel) => sum + (readNumber(barrel.plannedCount) ?? 0), 0);
+    const retainedCount = barrels.reduce((sum, barrel) => sum + (readNumber(barrel.retainedCount) ?? 0), 0);
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind,
+        artifact
+    };
+    const lines = [
+        `${kind.startsWith("exportsStarCollapse") ? "exports.star.collapse" : "exports.star.expand"} view ${handle}`,
+        `${barrels.length} ${barrels.length === 1 ? "barrel" : "barrels"}; ${plannedCount} ${plannedCount === 1 ? "edge" : "edges"} planned; ${retainedCount} retained`,
+        kind.startsWith("exportsStarCollapse")
+            ? "structured evidence includes exact edits, before hashes, semantic fingerprints, diagnostics, cycles, owners and surfaces"
+            : "structured evidence includes exact edits, before hashes, semantic fingerprints, diagnostics, cycles, owners and consumers"
+    ];
+    return (0, agent_text_1.attachAgentText)(response, lines.join("\n"));
+}
+function buildImportsNormalizeViewResponse(cwd, artifact, options, handle) {
+    const rawEdits = readObjectList(artifact.hiddenEdits).length > 0
+        ? readObjectList(artifact.hiddenEdits)
+        : readObjectList(artifact.edits);
+    const filteredEdits = filterItems(rawEdits, options, (item) => [
+        readString(item.file),
+        readString(item.from),
+        readString(item.to),
+        ...readStringList(item.specifiers)
+    ]);
+    const offset = Math.max(0, options.offset ?? 0);
+    const defaultLimit = Math.min(filteredEdits.length || 1, 20);
+    const limit = Math.max(1, options.limit ?? defaultLimit);
+    const edits = filteredEdits.slice(offset, offset + limit);
+    const hidden = Math.max(0, filteredEdits.length - offset - edits.length);
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind: "importsNormalize",
+        operation: readString(artifact.operation) ?? "imports.normalize",
+        ...(readString(artifact.mode) !== undefined ? { mode: readString(artifact.mode) } : {}),
+        ...(readString(artifact.target) !== undefined ? { target: readString(artifact.target) } : {}),
+        policyGroups: readObjectList(artifact.policyGroups),
+        edits,
+        hiddenFiles: readStringList(artifact.hiddenFiles),
+        ...(readNumber(artifact.hiddenFileCount) !== null ? { hiddenFileCount: readNumber(artifact.hiddenFileCount) } : {}),
+        offset,
+        limit,
+        total: filteredEdits.length,
+        ...(hidden > 0 ? { hidden } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatImportsNormalizeViewResponse(cwd, response));
+}
+function formatImportsNormalizeViewResponse(cwd, response) {
+    const handle = readString(response.handle) ?? "";
+    const total = readNumber(response.total) ?? readObjectList(response.edits).length;
+    const hiddenFiles = readStringList(response.hiddenFiles);
+    const totalFiles = readNumber(response.hiddenFileCount) ?? hiddenFiles.length;
+    const lines = [
+        `imports.normalize ${handle}`,
+        `${total} hidden import ${total === 1 ? "edit" : "edits"}${totalFiles > 0 ? `; ${totalFiles} hidden ${totalFiles === 1 ? "file" : "files"}` : ""}`
+    ];
+    if (readObjectList(response.edits).length > 0) {
+        lines.push("hidden edits:");
+    }
+    for (const [file, edits] of groupBy(readObjectList(response.edits), (item) => readString(item.file) ?? "")) {
+        if (file) {
+            lines.push(formatViewPath(cwd, file));
+        }
+        for (const edit of edits) {
+            const from = readString(edit.from);
+            const to = readString(edit.to);
+            if (from && to) {
+                lines.push(`  ${from} -> ${to}`);
+            }
+        }
+    }
+    const hidden = readNumber(response.hidden) ?? 0;
+    if (hidden > 0) {
+        lines.push(`+ ${hidden} more import edits hidden`);
+    }
+    if (hiddenFiles.length > 0) {
+        lines.push("hidden files:");
+        const visibleHiddenFiles = hiddenFiles.slice(0, 12);
+        for (const file of visibleHiddenFiles) {
+            lines.push(formatViewPath(cwd, file));
+        }
+        if (totalFiles > visibleHiddenFiles.length) {
+            lines.push(`+ ${totalFiles - visibleHiddenFiles.length} more files hidden`);
+        }
+    }
+    return lines.join("\n");
+}
+function buildMutationFilesViewResponse(cwd, artifact, options, handle) {
+    const rawFiles = readStringList(artifact.files);
+    const filteredFiles = filterStrings(rawFiles, options);
+    const offset = Math.max(0, options.offset ?? 0);
+    const defaultLimit = filteredFiles.length || 1;
+    const limit = Math.max(1, options.limit ?? defaultLimit);
+    const files = filteredFiles.slice(offset, offset + limit);
+    const hidden = Math.max(0, filteredFiles.length - offset - files.length);
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind: "mutationFiles",
+        operation: readString(artifact.operation) ?? "mutate",
+        label: readString(artifact.label) ?? "files",
+        files,
+        offset,
+        limit,
+        total: filteredFiles.length,
+        ...(hidden > 0 ? { hidden } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatMutationFilesViewResponse(cwd, response));
+}
+function filterStrings(items, options) {
+    const only = options.only ?? [];
+    const except = options.except ?? [];
+    const base = only.length > 0
+        ? items.filter((item) => matchesAnySelector([item], only))
+        : items;
+    return except.length > 0
+        ? base.filter((item) => !matchesAnySelector([item], except))
+        : base;
+}
+function formatMutationFilesViewResponse(cwd, response) {
+    const label = readString(response.label) ?? "files";
+    const handle = readString(response.handle) ?? "";
+    const total = readNumber(response.total) ?? readStringList(response.files).length;
+    const lines = [`hidden ${label} ${handle}`, `${total} hidden ${total === 1 ? "file" : "files"}`];
+    for (const file of readStringList(response.files)) {
+        lines.push(formatViewPath(cwd, file));
+    }
+    const hidden = readNumber(response.hidden) ?? 0;
+    if (hidden > 0) {
+        lines.push(`+ ${hidden} more files hidden`);
+    }
+    return lines.join("\n");
+}
+function buildListViewResponse(artifact, options, handle, kind) {
+    const rawItems = Array.isArray(artifact.items) ? artifact.items.filter(isObject) : [];
+    const filteredItems = filterItems(rawItems, options, (item) => [
+        readString(item.name),
+        readString(item.text)?.split(/\s+/)[0]
+    ]);
+    const offset = Math.max(0, options.offset ?? 0);
+    const defaultLimit = filteredItems.length || 1;
+    const limit = Math.max(1, options.limit ?? defaultLimit);
+    const items = filteredItems.slice(offset, offset + limit);
+    const hidden = Math.max(0, filteredItems.length - offset - items.length);
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind,
+        source: readString(artifact.source) ?? "inspect",
+        ...(readString(artifact.file) !== undefined ? { file: readString(artifact.file) } : {}),
+        ...(readString(artifact.entity) !== undefined ? { entity: readString(artifact.entity) } : {}),
+        ...(readString(artifact.target) !== undefined ? { target: readString(artifact.target) } : {}),
+        ...(readString(artifact.detail) !== undefined ? { detail: readString(artifact.detail) } : {}),
+        items,
+        offset,
+        limit,
+        ...(hidden > 0 ? { hidden } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatListViewResponse(response));
+}
+function buildCodeViewResponse(artifact, options, handle) {
+    const rawItems = Array.isArray(artifact.items) ? artifact.items.filter(isObject) : [];
+    const filteredItems = filterItems(rawItems, options, (item) => [readString(item.entity), readString(item.name)]);
+    const offset = Math.max(0, options.offset ?? 0);
+    const defaultLimit = filteredItems.length || 1;
+    const limit = Math.max(1, options.limit ?? defaultLimit);
+    const items = filteredItems.slice(offset, offset + limit);
+    const hidden = Math.max(0, filteredItems.length - offset - items.length);
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind: "code",
+        source: readString(artifact.source) ?? "inspect",
+        items,
+        offset,
+        limit,
+        ...(hidden > 0 ? { hidden } : {}),
+        ...(items.length === 0 && rawItems.length > 0 && hasViewFilters(options) ? { noMatches: true } : {})
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatCodeViewResponse(response));
+}
+function formatCodeViewResponse(response) {
+    const lines = [];
+    const items = Array.isArray(response.items) ? response.items.filter(isObject) : [];
+    if (items.length === 0 && response.noMatches === true) {
+        lines.push("no hidden code matched view filters");
+        return lines.join("\n");
+    }
+    let currentFile = "";
+    for (const item of items) {
+        const file = readString(item.file) ?? "";
+        if (file && file !== currentFile) {
+            if (lines.length > 0) {
+                lines.push("");
+            }
+            lines.push(`// ${file}`);
+            currentFile = file;
+        }
+        const entity = readString(item.entity) ?? "";
+        const meta = readString(item.meta) ?? readString(item.rangeMeta) ?? "";
+        const header = [entity, meta].filter((part) => part !== "").join(" ");
+        if (header) {
+            lines.push(`// ${header}`);
+        }
+        const code = readString(item.code);
+        if (code) {
+            lines.push(code.trimEnd());
+        }
+    }
+    const hidden = readNumber(response.hidden) ?? 0;
+    if (hidden > 0) {
+        lines.push(`+ ${hidden} more hidden code blocks`);
+    }
+    return lines.join("\n");
+}
+function formatListViewResponse(response) {
+    const lines = [];
+    const file = readString(response.file);
+    const target = readString(response.target);
+    const kind = readString(response.kind) ?? "";
+    const detail = readString(response.detail);
+    if (file) {
+        lines.push(`// ${file}`);
+    }
+    else if (kind === "usages") {
+        lines.push(detail ? `usages ${detail}` : "usages");
+    }
+    else if (target) {
+        lines.push(`duplicates ${target}`);
+    }
+    const entity = readString(response.entity);
+    if (entity) {
+        lines.push(`// ${entity}:`);
+    }
+    const items = Array.isArray(response.items) ? response.items.filter(isObject) : [];
+    if (kind === "usages") {
+        for (const [name, groupItems] of groupBy(items, (item) => readString(item.name) ?? "")) {
+            if (name) {
+                lines.push(`${name}:`);
+            }
+            for (const item of groupItems) {
+                const text = readString(item.text);
+                if (text) {
+                    lines.push(text.trimEnd());
+                }
+            }
+        }
+    }
+    else {
+        for (const item of items) {
+            const text = readString(item.text);
+            if (text) {
+                lines.push(text.trimEnd());
+            }
+        }
+    }
+    const hidden = readNumber(response.hidden) ?? 0;
+    if (hidden > 0) {
+        lines.push(`+ ${hidden} more hidden ${kind === "members" ? "members" : kind === "usages" ? "usages" : "items"}`);
+    }
+    return lines.join("\n");
+}
+function groupBy(items, keyFn) {
+    const groups = new Map();
+    for (const item of items) {
+        const key = keyFn(item);
+        const current = groups.get(key) ?? [];
+        current.push(item);
+        groups.set(key, current);
+    }
+    return Array.from(groups.entries());
+}
+function readCyclesDetail(value) {
+    if (value === "summary" || value === "sum") {
+        return "summary";
+    }
+    if (value === "imports" || value === "files") {
+        return value;
+    }
+    throw new errors_1.CliError("INVALID_CYCLES_DETAIL", "aib view cycles --detail expects summary, imports, or files.");
+}
+function readCyclesKind(value) {
+    if (value === "runtime" || value === "type-only" || value === "mixed") {
+        return value;
+    }
+    throw new errors_1.CliError("INVALID_CYCLES_KIND", "aib view cycles --kind expects runtime, type-only, or mixed.");
+}
+function readFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    const value = index >= 0 ? args[index + 1] : undefined;
+    return value && !value.startsWith("--") ? value : undefined;
+}
+function buildDeclarationMutationViewResponse(cwd, artifact, handle) {
+    const rows = Array.isArray(artifact.rows) ? artifact.rows.filter(isObject) : [];
+    const operation = readString(artifact.operation) === "addMissing" ? "addMissing" : "remove";
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind: "declarationMutation",
+        operation,
+        rows,
+        sourceFailures: Array.isArray(artifact.sourceFailures) ? artifact.sourceFailures.filter(isObject) : [],
+        skipped: Array.isArray(artifact.skipped) ? artifact.skipped.filter(isObject) : []
+    };
+    return (0, agent_text_1.attachAgentText)(response, formatDeclarationMutationView(cwd, response));
+}
+function formatDeclarationMutationView(cwd, response) {
+    const lines = [`${readString(response.operation) ?? "declaration"} ${readString(response.handle) ?? ""}`.trim()];
+    const rows = Array.isArray(response.rows) ? response.rows.filter(isObject) : [];
+    lines.push(...(0, declaration_format_1.formatDeclarationMutationDetails)(cwd, readString(response.operation) === "addMissing" ? "addMissing" : "remove", rows));
+    appendDeclarationViewFailureLines(lines, response);
+    appendDeclarationViewSkippedLines(lines, response);
+    return lines.join("\n");
+}
+function buildDeclarationCleanupViewResponse(cwd, artifact, handle) {
+    const cleanups = Array.isArray(artifact.cleanups) ? artifact.cleanups.filter(isObject) : [];
+    const response = {
+        ok: true,
+        op: "view",
+        handle,
+        kind: "declarationCleanup",
+        cleanups,
+        filesWritten: readStringList(artifact.filesWritten)
+    };
+    const operation = readString(artifact.operation);
+    if (operation) {
+        response.operation = operation;
+    }
+    return (0, agent_text_1.attachAgentText)(response, formatDeclarationCleanupView(cwd, response));
+}
+function formatDeclarationCleanupView(cwd, response) {
+    const lines = [`cleanup ${readString(response.handle) ?? ""}`.trim()];
+    const cleanups = Array.isArray(response.cleanups) ? response.cleanups.filter(isObject) : [];
+    appendDeclarationCleanupViewOperationLines(cwd, lines, cleanups, "remove");
+    appendDeclarationCleanupViewOperationLines(cwd, lines, cleanups, "addMissing");
+    appendDeclarationCleanupViewNotFoundLines(cwd, lines, cleanups);
+    appendDeclarationCleanupViewFailureLines(cwd, lines, cleanups);
+    appendDeclarationCleanupViewSkippedLines(lines, cleanups);
+    const filesWritten = readStringList(response.filesWritten);
+    if (filesWritten.length > 0) {
+        lines.push("filesWritten:");
+        for (const file of filesWritten) {
+            lines.push(`  ${formatViewPath(cwd, file)}`);
+        }
+    }
+    return lines.join("\n");
+}
+function appendDeclarationCleanupViewOperationLines(cwd, lines, cleanups, operation) {
+    const noopSelectors = operation === "addMissing" ? collectDeclarationCleanupNoopSelectors(cleanups) : [];
+    const rows = cleanups
+        .filter((cleanup) => readDeclarationCleanupOperation(cleanup) === operation)
+        .flatMap((cleanup) => Array.isArray(cleanup.rows) ? cleanup.rows.filter(isObject) : [])
+        .filter((row) => hasDeclarationOperationItems(row, operation))
+        .map((row) => sanitizeDeclarationOperationRow(row));
+    if (rows.length === 0 && noopSelectors.length === 0) {
+        return;
+    }
+    lines.push(`${operation}:`);
+    for (const line of (0, declaration_format_1.formatDeclarationMutationDetails)(cwd, operation, rows)) {
+        lines.push(line ? `  ${line}` : "");
+    }
+    if (noopSelectors.length > 0) {
+        lines.push(`  no-op selectors: ${noopSelectors.join(", ")}`);
+    }
+}
+function appendDeclarationCleanupViewNotFoundLines(cwd, lines, cleanups) {
+    const bySelector = new Map();
+    for (const cleanup of cleanups) {
+        if (!isObject(cleanup.notFound)) {
+            continue;
+        }
+        for (const [selector, files] of Object.entries(cleanup.notFound)) {
+            const fileList = Array.isArray(files)
+                ? files.filter((file) => typeof file === "string" && file.trim() !== "")
+                : [];
+            bySelector.set(selector, uniqueStrings([...(bySelector.get(selector) ?? []), ...fileList]));
+        }
+    }
+    if (bySelector.size === 0) {
+        return;
+    }
+    lines.push("notFound:");
+    for (const [selector, files] of bySelector.entries()) {
+        lines.push(`  ${selector}:`);
+        for (const file of files) {
+            lines.push(`    ${formatViewPath(cwd, file)}`);
+        }
+    }
+}
+function appendDeclarationCleanupViewFailureLines(cwd, lines, cleanups) {
+    const failures = uniqueFailureObjects(cleanups.flatMap((cleanup) => [
+        ...readObjectList(cleanup.failures),
+        ...readObjectList(cleanup.sourceFailures)
+    ]));
+    if (failures.length === 0) {
+        return;
+    }
+    lines.push("failed:");
+    const removeAmbiguous = failures.filter((failure) => readString(failure.code) === "DECLARATION_REMOVE_AMBIGUOUS");
+    const addMissingAmbiguous = failures.filter((failure) => readString(failure.code) === "DECLARATION_ADD_MISSING_SOURCE_AMBIGUOUS");
+    const addMissingNotFound = failures.filter((failure) => readString(failure.code) === "DECLARATION_ADD_MISSING_SOURCE_NOT_FOUND");
+    const otherFailures = failures.filter((failure) => !removeAmbiguous.includes(failure) &&
+        !addMissingAmbiguous.includes(failure) &&
+        !addMissingNotFound.includes(failure));
+    if (removeAmbiguous.length > 0) {
+        lines.push("  remove:");
+        lines.push("    ambiguous selectors:");
+        for (const failure of removeAmbiguous) {
+            const selector = readString(failure.selector) ?? "selector";
+            const file = readString(failure.file);
+            const available = readStringList(failure.availableSelectors);
+            lines.push(`      ${selector}${file ? ` in ${formatViewPath(cwd, file)}` : ""}${available.length > 0 ? `: ${available.join(", ")}` : ""}`);
+        }
+    }
+    if (addMissingAmbiguous.length > 0 || addMissingNotFound.length > 0 || otherFailures.length > 0) {
+        lines.push("  addMissing:");
+        if (addMissingAmbiguous.length > 0) {
+            lines.push("    ambiguous preferred source:");
+            for (const failure of addMissingAmbiguous) {
+                const selector = readString(failure.selector) ?? "selector";
+                lines.push(`      ${selector}:`);
+                for (const source of readStringList(failure.sources)) {
+                    lines.push(`        ${formatViewPath(cwd, source)}`);
+                }
+            }
+        }
+        if (addMissingNotFound.length > 0) {
+            lines.push(`    source not found: ${readFailureSelectors(addMissingNotFound).join(", ")}`);
+        }
+        for (const failure of otherFailures) {
+            lines.push(`    ${readString(failure.selector) ?? "selector"}: ${readString(failure.error) ?? readString(failure.code) ?? "failed"}`);
+        }
+    }
+}
+function appendDeclarationCleanupViewSkippedLines(lines, cleanups) {
+    const skipped = cleanups.flatMap((cleanup) => readObjectList(cleanup.skipped));
+    if (skipped.length === 0) {
+        return;
+    }
+    lines.push("skipped:");
+    for (const item of skipped) {
+        const selector = readString(item.selector) ?? "selector";
+        const operation = readString(item.operation) ?? "operation";
+        const reason = readString(item.reason);
+        lines.push(`  ${selector}: ${operation} skipped${reason ? ` because ${formatSkippedReason(reason)}` : ""}`);
+    }
+}
+function readDeclarationCleanupOperation(cleanup) {
+    const operation = readString(cleanup.operation);
+    if (operation?.includes(".remove.")) {
+        return "remove";
+    }
+    if (operation?.includes(".addMissing.")) {
+        return "addMissing";
+    }
+    return "unknown";
+}
+function appendDeclarationViewFailureLines(lines, response) {
+    const failures = Array.isArray(response.sourceFailures) ? response.sourceFailures.filter(isObject) : [];
+    if (failures.length === 0) {
+        return;
+    }
+    lines.push("failed:");
+    for (const failure of failures) {
+        const selector = readString(failure.selector) ?? "selector";
+        const code = readString(failure.code);
+        if (code === "DECLARATION_ADD_MISSING_SOURCE_AMBIGUOUS") {
+            lines.push(`${selector}: multiple preferred sources export selector`);
+            const sources = Array.isArray(failure.sources)
+                ? failure.sources.filter((item) => typeof item === "string" && item.trim() !== "")
+                : [];
+            for (const source of sources) {
+                lines.push(`  ${source}`);
+            }
+            continue;
+        }
+        if (code === "DECLARATION_ADD_MISSING_SOURCE_NOT_FOUND") {
+            lines.push(`${selector}: no preferred source exports selector`);
+            continue;
+        }
+        lines.push(`${selector}: ${readString(failure.error) ?? code ?? "failed"}`);
+    }
+}
+function appendDeclarationViewSkippedLines(lines, response) {
+    const skipped = Array.isArray(response.skipped) ? response.skipped.filter(isObject) : [];
+    if (skipped.length === 0) {
+        return;
+    }
+    lines.push("skipped:");
+    for (const item of skipped) {
+        const selector = readString(item.selector) ?? "selector";
+        const operation = readString(item.operation);
+        const reason = readString(item.reason);
+        lines.push(`${selector}: ${operation ?? "operation"} skipped${reason ? ` because ${formatSkippedReason(reason)}` : ""}`);
+    }
+}
+function hasDeclarationOperationItems(row, operation) {
+    const value = operation === "remove" ? row.removed : row.addedImports;
+    return Array.isArray(value) && value.length > 0;
+}
+function collectDeclarationCleanupNoopSelectors(cleanups) {
+    const noOp = new Set();
+    for (const cleanup of cleanups) {
+        if (readDeclarationCleanupOperation(cleanup) !== "addMissing") {
+            continue;
+        }
+        if (isObject(cleanup.noOp)) {
+            for (const selector of Object.keys(cleanup.noOp)) {
+                noOp.add(selector);
+            }
+        }
+    }
+    return uniqueStrings([...noOp]);
+}
+function sanitizeDeclarationOperationRow(row) {
+    if (row.ok !== false) {
+        return row;
+    }
+    const sanitized = { ...row, ok: true };
+    delete sanitized.failures;
+    delete sanitized.failedSelector;
+    delete sanitized.availableSelectors;
+    delete sanitized.code;
+    delete sanitized.error;
+    return sanitized;
+}
+function formatSkippedReason(reason) {
+    return reason === "remove not applied" ? "remove was not applied" : reason;
+}
+function readObjectList(value) {
+    return Array.isArray(value) ? value.filter(isObject) : [];
+}
+function uniqueFailureObjects(items) {
+    const seen = new Set();
+    const result = [];
+    for (const item of items) {
+        const key = [
+            readString(item.selector),
+            readString(item.file),
+            readString(item.code),
+            readString(item.error),
+            readStringList(item.sources).join(","),
+            readStringList(item.availableSelectors).join(",")
+        ].join("|");
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        result.push(item);
+    }
+    return result;
+}
+function uniqueStrings(values) {
+    return [...new Set(values.filter((value) => value.trim() !== ""))];
+}
+function readFailureSelectors(failures) {
+    return uniqueStrings(failures.map((failure) => readString(failure.selector)).filter((selector) => Boolean(selector)));
+}
+function formatViewPath(cwd, value) {
+    const normalized = value.replace(/\\/g, "/");
+    if (!path.isAbsolute(value)) {
+        return normalized;
+    }
+    const relative = path.relative(cwd, value).replace(/\\/g, "/");
+    return relative && !relative.startsWith("../") && !path.isAbsolute(relative)
+        ? relative
+        : normalized;
+}
+function readFlagValues(args, flag) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        if (args[index] !== flag) {
+            continue;
+        }
+        const value = args[index + 1];
+        if (value && !value.startsWith("--")) {
+            values.push(value);
+        }
+    }
+    return values;
+}
+function readOptionalIntegerFlag(args, flag) {
+    const value = readFlagValue(args, flag);
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    const minimum = flag === "--offset" ? 0 : 1;
+    if (!Number.isInteger(parsed) || parsed < minimum) {
+        throw new errors_1.CliError("INVALID_VIEW_OPTION", `${flag} expects ${minimum === 0 ? "a non-negative" : "a positive"} integer.`);
+    }
+    return parsed;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readString(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function numberField(value, field) {
+    const raw = value[field];
+    return typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+}
+function readStringList(value) {
+    if (typeof value === "string" && value !== "") {
+        return expandSelectorInput(value);
+    }
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === "string" && item !== "").flatMap(expandSelectorInput);
+    }
+    return [];
+}
+function filterItems(items, options, keysForItem) {
+    const only = options.only ?? [];
+    const except = options.except ?? [];
+    const base = only.length > 0
+        ? items.filter((item) => matchesAnySelector(keysForItem(item), only))
+        : items;
+    if (except.length === 0) {
+        return base;
+    }
+    return base.filter((item) => !matchesAnySelector(keysForItem(item), except));
+}
+function hasViewFilters(options) {
+    return (options.only?.length ?? 0) > 0 || (options.except?.length ?? 0) > 0;
+}
+function matchesAnySelector(keys, selectors) {
+    return keys.some((key) => key !== undefined && selectors.some((selector) => selectorMatches(key, selector)));
+}
+function selectorMatches(value, selector) {
+    if (value === selector) {
+        return true;
+    }
+    const valueLast = value.split(".").pop() ?? value;
+    const selectorLast = selector.split(".").pop() ?? selector;
+    return valueLast === selectorLast && !selector.includes(".");
+}
+function expandSelectorInput(value) {
+    const trimmed = value.trim();
+    const bracketItems = parseBracketList(trimmed);
+    return (bracketItems ?? splitCommaList(trimmed)).flatMap(expandSelectorToken);
+}
+function expandSelectorToken(token) {
+    const trimmed = token.trim();
+    const groupMatch = trimmed.match(/^(.+)\.\{(.+)\}$/);
+    if (groupMatch) {
+        const parent = groupMatch[1];
+        const members = groupMatch[2];
+        if (parent && members) {
+            return splitCommaList(members).map((member) => `${parent}.${member}`);
+        }
+    }
+    return trimmed ? [trimmed] : [];
+}
+function parseBracketList(value) {
+    if (!value.startsWith("[") || !value.endsWith("]")) {
+        return null;
+    }
+    const inner = value.slice(1, -1).trim();
+    return inner ? splitCommaList(inner) : [];
+}
+function splitCommaList(value) {
+    const items = [];
+    let current = "";
+    let braceDepth = 0;
+    for (const char of value) {
+        if (char === "{") {
+            braceDepth += 1;
+        }
+        else if (char === "}" && braceDepth > 0) {
+            braceDepth -= 1;
+        }
+        if (char === "," && braceDepth === 0) {
+            if (current.trim()) {
+                items.push(current.trim());
+            }
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    if (current.trim()) {
+        items.push(current.trim());
+    }
+    return items;
+}