mythik 0.1.5 → 0.2.0

package/README.md

@@ -1,11 +1,10 @@
 # mythik
 
-The Mythik runtime — types, validation, expressions, actions, spec
-stores, and versioning. This is the foundation every Mythik consumer
-imports. It also ships the canonical AI documentation bundled inside
-the npm tarball — so the docs an agent reads always match the
-installed version of the framework, no external doc fetching, no
-version drift.
+The Mythik contract runtime: types, validation, expressions, actions,
+spec stores, versioning, editor sessions, and **Reveal** context contracts.
+This is the foundation every Mythik consumer imports. It also ships the
+canonical AI documentation bundled inside the npm tarball, so the docs
+an agent reads always match the installed version of the framework.
 
 > See [the framework README on GitHub](https://github.com/mldixdev/mythik#readme)
 > for the full Mythik architecture and design philosophy. This file
@@ -13,8 +12,8 @@ version drift.
 
 ---
 
-## What Mythik is, briefly
-
+## What Mythik is, briefly
+
 Mythik is an **AI-first JSON-native app framework**. Most of your app
 lives as validated JSON specs loaded at runtime from your database,
 not source code that must be regenerated and redeployed for every
@@ -35,12 +34,13 @@ npm install mythik
 
 You install `mythik` whenever you're building anything Mythik-related:
 
-| You want to... | Install |
-|---|---|
-| Render specs as a React app | `mythik` + `mythik-react` |
-| Build a REST API from an ApiSpec | `mythik` + `mythik-server` |
-| Author or patch specs from the command line | `mythik` + `mythik-cli` (dev) |
-| Validate or query specs from a Node script | `mythik` alone |
+| You want to... | Install |
+|---|---|
+| Render specs as a React app | `mythik` + `mythik-react` |
+| Render specs in React Native or Expo | `mythik` + `mythik-react-native` |
+| Build a REST API from an ApiSpec | `mythik` + `mythik-server` |
+| Author or patch specs from the command line | `mythik` + `mythik-cli` (dev) |
+| Validate or query specs from a Node script | `mythik` alone |
 
 ## What you get
 
@@ -73,6 +73,12 @@ You install `mythik` whenever you're building anything Mythik-related:
   `mythik-react`, but the runtime lives here and can be used directly
   for non-React shells or custom integrations.
 
+- **Mythik Reveal contracts** — typed runtime context, redaction,
+  truncation, event recorder, and protocol shapes used by the React,
+  React Native, and CLI **Reveal** integrations. **Reveal** lets a running app
+  expose its live contract, selected state, events, diagnostics, and
+  environment as structured context for AI agents.
+
 ## Browser-safe vs Node-only entries
 
 ```ts
@@ -188,7 +194,7 @@ node_modules/mythik/docs/
 │   ├── ai-context-custom-elements.md    # custom expressions/actions
 │   ├── reference-doc.md                 # full rule catalog
 │   └── WHERE-TO-LOOK.md                 # navigation guide
-├── wiki/compiled/                       # 327 atomic per-concept articles
+├── wiki/compiled/                       # atomic per-concept articles
 └── llms.txt                             # index for LLM tooling
 ```
 
@@ -205,25 +211,55 @@ $ npx mythik docs copy ./mythik-docs
 Point your AI agent at the printed path before asking it to author or
 modify specs.
 
-## Related packages
+For runtime debugging, pair these docs with **Mythik Reveal**:
 
-- [`mythik-react`](https://github.com/mldixdev/mythik/tree/main/packages/react#readme) — render the specs as a React app
-- [`mythik-cli`](https://github.com/mldixdev/mythik/tree/main/packages/cli#readme) — author and patch specs from the command line (the AI-first surface)
-- [`mythik-server`](https://github.com/mldixdev/mythik/tree/main/packages/server#readme) — declarative REST server from an `ApiSpec`
-- [`mythik-react-native`](https://github.com/mldixdev/mythik/tree/main/packages/react-native#readme) — render supported Mythik primitives in Expo and React Native
-
-## Status
-
-Public release line. APIs are documented for real-world feedback as
-the framework evolves.
+```bash
+npx mythik reveal start
+npx mythik reveal apps --json
+npx mythik reveal context --app <app-name>
+```
+
+Docs explain the contract; **Reveal** shows what the running app actually
+mounted.
 
-## Releases
+For fresh AI agents, install the local operating protocol before asking
+for spec changes. `agent init` currently supports `codex`, `claude`, and
+`all`. `codex` creates/updates `AGENTS.md`, `claude` creates/updates
+`CLAUDE.md`, and `all` updates both. Existing agent files are preserved
+outside the Mythik-managed block delimited by
+`<!-- mythik-agent-protocol:start -->` and
+`<!-- mythik-agent-protocol:end -->`.
 
-Release notes and patch details are published in the
-[CHANGELOG](https://github.com/mldixdev/mythik/blob/main/CHANGELOG.md)
-and on
-[GitHub Releases](https://github.com/mldixdev/mythik/releases).
+The adapters point the agent to shared `.mythik/agent/*` instructions:
 
-## License
+```bash
+npx mythik agent init codex
+npx mythik agent context --app <app-id> --include-screens --out .mythik/agent/context.md
+```
 
-Apache-2.0.
+The generated protocol names the active Mythik store as the source of
+truth and keeps existing spec edits on
+`manifest -> elements -> patch --from-file --author -> validate -> verify`.
+
+## Related packages
+
+- [`mythik-react`](https://github.com/mldixdev/mythik/tree/main/packages/react#readme) — render the specs as a React app
+- [`mythik-cli`](https://github.com/mldixdev/mythik/tree/main/packages/cli#readme) — **Agent Protocol**, patch workflow, validation, versioning, environments, and **Reveal** commands
+- [`mythik-server`](https://github.com/mldixdev/mythik/tree/main/packages/server#readme) — declarative REST server from an `ApiSpec`
+- [`mythik-react-native`](https://github.com/mldixdev/mythik/tree/main/packages/react-native#readme) — render supported Mythik primitives in Expo and React Native
+
+## Status
+
+Public release line. APIs are documented for real-world feedback as
+the framework evolves.
+
+## Releases
+
+Release notes and patch details are published in the
+[CHANGELOG](https://github.com/mldixdev/mythik/blob/main/CHANGELOG.md)
+and on
+[GitHub Releases](https://github.com/mldixdev/mythik/releases).
+
+## License
+
+Apache-2.0.

package/dist/actions/transaction-engine.d.ts

@@ -5,9 +5,19 @@ export interface TransactionEngineConfig {
     store: StateStore;
     dispatcher: ActionDispatcherInstance;
     resolve: ResolveFn;
+    observer?: TransactionObserver;
 }
 export interface TransactionEngine {
     execute: (config: TransactionConfig) => Promise<void>;
 }
+export interface TransactionObserverEvent {
+    phase: 'transaction' | 'before' | 'optimistic' | 'confirm' | 'onSuccess' | 'onError';
+    status: 'start' | 'success' | 'error' | 'rollback';
+    actionCount?: number;
+    message?: string;
+}
+export interface TransactionObserver {
+    onTransactionEvent?: (event: TransactionObserverEvent) => void;
+}
 export declare function createTransactionEngine(config: TransactionEngineConfig): TransactionEngine;
 //# sourceMappingURL=transaction-engine.d.ts.map

package/dist/actions/transaction-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-engine.d.ts","sourceRoot":"","sources":["../../src/actions/transaction-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,wBAAwB,CAAC;IACrC,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAqDD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAwG1F"}
+{"version":3,"file":"transaction-engine.d.ts","sourceRoot":"","sources":["../../src/actions/transaction-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,wBAAwB,CAAC;IACrC,OAAO,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACrF,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;CAChE;AAqDD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CAmH1F"}

package/dist/actions/transaction-engine.js

@@ -39,7 +39,15 @@ function normalizeTransactionError(error, fallbackMessage = 'Transaction failed'
     };
 }
 export function createTransactionEngine(config) {
-    const { store, dispatcher, resolve } = config;
+    const { store, dispatcher, resolve, observer } = config;
+    const emit = (event) => {
+        try {
+            observer?.onTransactionEvent?.(event);
+        }
+        catch {
+            // Reveal observers must never alter transaction semantics.
+        }
+    };
     // --- Queue: one transaction at a time ---
     let running = false;
     const queue = [];
@@ -64,6 +72,7 @@ export function createTransactionEngine(config) {
     // --- Core transaction logic ---
     async function runTransaction(txConfig) {
         const timeout = txConfig.timeout ?? DEFAULT_TIMEOUT;
+        emit({ phase: 'transaction', status: 'start' });
         // Phase 1: before (not rolled back)
         if (txConfig.before && txConfig.before.length > 0) {
             await executeActions(txConfig.before);
@@ -93,12 +102,15 @@ export function createTransactionEngine(config) {
             if (txConfig.onSuccess && txConfig.onSuccess.length > 0) {
                 await executeActions(txConfig.onSuccess);
             }
+            emit({ phase: 'transaction', status: 'success' });
         }
         catch (err) {
             // Rollback: restore snapshot atomically (single set, one re-render)
             store.set('/', snapshot);
+            emit({ phase: 'transaction', status: 'rollback' });
             // Write error after rollback so root restore cannot erase details.
             store.set('/tx/error', confirmError ?? normalizeTransactionError(err));
+            emit({ phase: 'transaction', status: 'error', message: err instanceof Error ? err.message : 'Transaction failed' });
             // Phase 5b: onError (after rollback)
             if (txConfig.onError && txConfig.onError.length > 0) {
                 try {

package/dist/actions/transaction-engine.js.map

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

package/dist/agent-context/inventory.d.ts

@@ -0,0 +1,62 @@
+import type { FetchReference } from '../contract/types.js';
+import type { RevealRedactionPolicy } from '../reveal/types.js';
+export interface AgentElementSummary {
+    id: string;
+    type: string;
+    props?: Record<string, unknown>;
+}
+export interface AgentScreenRef {
+    id: string;
+    label?: string;
+    icon?: string;
+    description?: string;
+}
+export interface AgentEndpointSummary {
+    id: string;
+    method: string;
+    path: string;
+    kind: 'query' | 'crud' | 'handler' | 'unknown';
+}
+export interface AgentCatalogSummary {
+    id: string;
+    kind: 'static' | 'distinct' | 'valueLabel' | 'unknown';
+}
+export interface AgentDataSourceSummary {
+    id: string;
+    method: string;
+    url: string;
+}
+export interface AgentEditorSessionSummary {
+    id: string;
+    paths: string[];
+}
+export interface AgentDocumentSummary {
+    id: string;
+    type: 'screen' | 'app' | 'api' | 'unknown';
+    root?: string;
+    elementCount?: number;
+    elements?: AgentElementSummary[];
+    screens?: AgentScreenRef[];
+    endpoints?: AgentEndpointSummary[];
+    catalogs?: AgentCatalogSummary[];
+}
+export interface AgentDocumentInventory {
+    readerPaths: string[];
+    writerPaths: string[];
+    actions: string[];
+    dataSources: AgentDataSourceSummary[];
+    editorSessions: AgentEditorSessionSummary[];
+    authGates: string[];
+    reservedWrites: string[];
+    fetchReferences: FetchReference[];
+}
+export interface AgentDocumentInspection {
+    summary: AgentDocumentSummary;
+    inventory: AgentDocumentInventory;
+    screenIds: string[];
+}
+export interface InspectAgentDocumentOptions {
+    redaction?: RevealRedactionPolicy;
+}
+export declare function inspectAgentDocument(id: string, doc: unknown, options?: InspectAgentDocumentOptions): AgentDocumentInspection;
+//# sourceMappingURL=inventory.d.ts.map

package/dist/agent-context/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../src/agent-context/inventory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,sBAAsB,EAAE,CAAC;IACtC,cAAc,EAAE,yBAAyB,EAAE,CAAC;IAC5C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,sBAAsB,CAAC;IAClC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AA+KD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,2BAAgC,GAAG,uBAAuB,CAqEjI"}

package/dist/agent-context/inventory.js

@@ -0,0 +1,248 @@
+import { extractFetchReferences } from '../contract/extractor.js';
+import { scanDeps } from '../renderer/deps.js';
+import { DEFAULT_REVEAL_REDACTION, redactRevealValue } from '../reveal/redaction.js';
+import { RESERVED_PATHS } from '../state/reserved-paths.js';
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function documentType(doc) {
+    if (!isRecord(doc))
+        return 'unknown';
+    if (doc.type === 'app')
+        return 'app';
+    if (doc.type === 'api')
+        return 'api';
+    if (typeof doc.root === 'string' && isRecord(doc.elements))
+        return 'screen';
+    return 'unknown';
+}
+function removePrivateAndFunctions(value) {
+    if (Array.isArray(value))
+        return value.map((item) => removePrivateAndFunctions(item));
+    if (!isRecord(value))
+        return typeof value === 'function' ? undefined : value;
+    const out = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (key.startsWith('_') || typeof child === 'function')
+            continue;
+        const cleaned = removePrivateAndFunctions(child);
+        if (cleaned !== undefined)
+            out[key] = cleaned;
+    }
+    return out;
+}
+function publicProps(element, redaction) {
+    if (!isRecord(element) || !isRecord(element.props))
+        return undefined;
+    const redacted = redactRevealValue(element.props, redaction);
+    const cleaned = removePrivateAndFunctions(redacted);
+    if (!isRecord(cleaned))
+        return undefined;
+    return Object.keys(cleaned).length > 0 ? cleaned : undefined;
+}
+function endpointKind(endpoint) {
+    if (endpoint.crud !== undefined)
+        return 'crud';
+    if (endpoint.query !== undefined)
+        return 'query';
+    if (endpoint.handler !== undefined)
+        return 'handler';
+    return 'unknown';
+}
+function catalogKind(catalog) {
+    if (catalog.static !== undefined)
+        return 'static';
+    if (catalog.distinct !== undefined)
+        return 'distinct';
+    if (catalog.value !== undefined || catalog.label !== undefined)
+        return 'valueLabel';
+    return 'unknown';
+}
+function redactUrlCredentials(value) {
+    return value.replace(/^([a-z][a-z0-9+.-]*:\/\/)([^/@\s]+)@/i, '$1[REDACTED]@');
+}
+function scanStringTemplatePaths(value) {
+    const paths = [];
+    const regex = /\$\{(\/[^}]+)\}/g;
+    let match;
+    while ((match = regex.exec(value)) !== null)
+        paths.push(match[1]);
+    return paths;
+}
+function isReservedPath(path) {
+    return Object.values(RESERVED_PATHS).some((reserved) => path === reserved || path.startsWith(`${reserved}/`));
+}
+function collectActionBindings(value, actions, writerPaths, reservedWrites) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectActionBindings(item, actions, writerPaths, reservedWrites);
+        return;
+    }
+    if (!isRecord(value))
+        return;
+    if (typeof value.action === 'string')
+        actions.add(value.action);
+    const params = isRecord(value.params) ? value.params : undefined;
+    const statePath = typeof params?.statePath === 'string' ? params.statePath : undefined;
+    if (statePath) {
+        writerPaths.add(statePath);
+        if (isReservedPath(statePath))
+            reservedWrites.add(statePath);
+    }
+    for (const child of Object.values(value))
+        collectActionBindings(child, actions, writerPaths, reservedWrites);
+}
+function buildDataSources(doc) {
+    if (!isRecord(doc.dataSources))
+        return [];
+    return Object.entries(doc.dataSources).map(([sourceId, source]) => {
+        const sourceRecord = isRecord(source) ? source : {};
+        return {
+            id: sourceId,
+            method: typeof sourceRecord.method === 'string' ? sourceRecord.method.toUpperCase() : 'GET',
+            url: typeof sourceRecord.url === 'string' ? redactUrlCredentials(sourceRecord.url) : '',
+        };
+    });
+}
+function buildEditorSessions(doc) {
+    if (!isRecord(doc.editorSessions))
+        return [];
+    return Object.entries(doc.editorSessions).map(([sessionId, session]) => {
+        const sessionRecord = isRecord(session) ? session : {};
+        return {
+            id: sessionId,
+            paths: Array.isArray(sessionRecord.paths) ? sessionRecord.paths.filter((path) => typeof path === 'string') : [],
+        };
+    });
+}
+function buildFetchReferences(id, doc) {
+    if (!doc.root || !doc.elements)
+        return [];
+    return extractFetchReferences(id, doc).map((ref) => ({
+        ...ref,
+        path: redactUrlCredentials(ref.path),
+        rawUrl: redactUrlCredentials(ref.rawUrl),
+    }));
+}
+function buildInventory(id, doc) {
+    const readerPaths = new Set();
+    const writerPaths = new Set();
+    const actions = new Set();
+    const reservedWrites = new Set();
+    const authGates = new Set();
+    for (const dep of scanDeps(doc)) {
+        readerPaths.add(dep);
+        if (dep.startsWith('/auth/'))
+            authGates.add(dep);
+    }
+    collectActionBindings(doc, actions, writerPaths, reservedWrites);
+    const dataSources = buildDataSources(doc);
+    const editorSessions = buildEditorSessions(doc);
+    const fetchReferences = buildFetchReferences(id, doc);
+    for (const source of dataSources) {
+        for (const path of scanStringTemplatePaths(source.url))
+            readerPaths.add(path);
+    }
+    for (const ref of fetchReferences) {
+        for (const path of scanStringTemplatePaths(ref.rawUrl))
+            readerPaths.add(path);
+    }
+    return {
+        readerPaths: [...readerPaths].sort(),
+        writerPaths: [...writerPaths].sort(),
+        actions: [...actions].sort(),
+        dataSources,
+        editorSessions,
+        authGates: [...authGates].sort(),
+        reservedWrites: [...reservedWrites].sort(),
+        fetchReferences,
+    };
+}
+function summarizeElements(elements, redaction) {
+    return Object.entries(elements).map(([elementId, element]) => {
+        const props = publicProps(element, redaction);
+        const type = isRecord(element) && typeof element.type === 'string' ? element.type : 'unknown';
+        return {
+            id: elementId,
+            type,
+            ...(props ? { props } : {}),
+        };
+    });
+}
+function summarizeScreens(screens) {
+    return Object.entries(screens).map(([screenId, screen]) => {
+        const screenRecord = isRecord(screen) ? screen : {};
+        return {
+            id: screenId,
+            ...(typeof screenRecord.label === 'string' ? { label: screenRecord.label } : {}),
+            ...(typeof screenRecord.icon === 'string' ? { icon: screenRecord.icon } : {}),
+            ...(typeof screenRecord.description === 'string' ? { description: screenRecord.description } : {}),
+        };
+    });
+}
+export function inspectAgentDocument(id, doc, options = {}) {
+    const type = documentType(doc);
+    const redaction = options.redaction ?? DEFAULT_REVEAL_REDACTION;
+    if (!isRecord(doc)) {
+        return { summary: { id, type: 'unknown' }, inventory: buildInventory(id, {}), screenIds: [] };
+    }
+    if (type === 'screen') {
+        const elements = isRecord(doc.elements) ? doc.elements : {};
+        return {
+            summary: {
+                id,
+                type,
+                root: String(doc.root),
+                elementCount: Object.keys(elements).length,
+                elements: summarizeElements(elements, redaction),
+            },
+            inventory: buildInventory(id, doc),
+            screenIds: [],
+        };
+    }
+    if (type === 'app') {
+        const layout = isRecord(doc.layout) ? doc.layout : {};
+        const elements = isRecord(layout.elements) ? layout.elements : {};
+        const screens = isRecord(doc.screens) ? doc.screens : {};
+        const screenRefs = summarizeScreens(screens);
+        return {
+            summary: {
+                id,
+                type,
+                ...(typeof layout.root === 'string' ? { root: layout.root } : {}),
+                elementCount: Object.keys(elements).length,
+                elements: summarizeElements(elements, redaction),
+                screens: screenRefs,
+            },
+            inventory: buildInventory(id, doc),
+            screenIds: screenRefs.map((screen) => screen.id),
+        };
+    }
+    if (type === 'api') {
+        const endpoints = isRecord(doc.endpoints) ? doc.endpoints : {};
+        const catalogs = isRecord(doc.catalogs) ? doc.catalogs : {};
+        return {
+            summary: {
+                id,
+                type,
+                endpoints: Object.entries(endpoints).map(([endpointId, endpoint]) => {
+                    const endpointRecord = isRecord(endpoint) ? endpoint : {};
+                    return {
+                        id: endpointId,
+                        method: typeof endpointRecord.method === 'string' ? endpointRecord.method.toUpperCase() : 'GET',
+                        path: typeof endpointRecord.path === 'string' ? endpointRecord.path : '',
+                        kind: endpointKind(endpointRecord),
+                    };
+                }),
+                catalogs: Object.entries(catalogs).map(([catalogId, catalog]) => {
+                    const catalogRecord = isRecord(catalog) ? catalog : {};
+                    return { id: catalogId, kind: catalogKind(catalogRecord) };
+                }),
+            },
+            inventory: buildInventory(id, doc),
+            screenIds: [],
+        };
+    }
+    return { summary: { id, type }, inventory: buildInventory(id, doc), screenIds: [] };
+}
+//# sourceMappingURL=inventory.js.map

package/dist/agent-context/inventory.js.map

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

package/dist/data/data-sources.d.ts

@@ -11,6 +11,18 @@ export interface DataSourcesEngineConfig {
         status: number;
         json: () => Promise<unknown>;
     }>;
+    observer?: DataSourcesObserver;
+}
+export interface DataSourceObserverEvent {
+    id: string;
+    target: string;
+    status: 'deferred' | 'start' | 'success' | 'http-error' | 'error';
+    method?: string;
+    statusCode?: number;
+    message?: string;
+}
+export interface DataSourcesObserver {
+    onDataSourceEvent?: (event: DataSourceObserverEvent) => void;
 }
 export interface DataSourcesEngine {
     /** Start reactive data fetching. Performs initial fetch for sources with initialFetch:true. */

package/dist/data/data-sources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-sources.d.ts","sourceRoot":"","sources":["../../src/data/data-sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CAC1H;AAED,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,wCAAwC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uFAAuF;IACvF,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;CAC7C;AAkBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CA+N1F"}
+{"version":3,"file":"data-sources.d.ts","sourceRoot":"","sources":["../../src/data/data-sources.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC9C,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACzH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,CAAC;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,+FAA+F;IAC/F,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kDAAkD;IAClD,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,wCAAwC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,uFAAuF;IACvF,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;CAC7C;AAkBD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,GAAG,iBAAiB,CA2O1F"}

package/dist/data/data-sources.js

@@ -16,6 +16,14 @@ function buildQueryString(params) {
 export function createDataSourcesEngine(config) {
     const { store, resolver, dataSources } = config;
     const fetcher = config.fetcher ?? globalThis.fetch?.bind(globalThis);
+    const emit = (event) => {
+        try {
+            config.observer?.onDataSourceEvent?.(event);
+        }
+        catch {
+            // Reveal observers must never alter data-source semantics.
+        }
+    };
     let mounted = false;
     let unsubscribe = null;
     const debounceTimers = new Map();
@@ -62,6 +70,7 @@ export function createDataSourcesEngine(config) {
                 if (value === undefined || value === null || value === '') {
                     store.set(`/${deferredPath}`, true);
                     store.set(`/${loadingPath}`, false);
+                    emit({ id, target, status: 'deferred' });
                     return;
                 }
             }
@@ -95,21 +104,25 @@ export function createDataSourcesEngine(config) {
             if (ds.headers) {
                 options.headers = resolver.resolve(ds.headers);
             }
+            emit({ id, target, status: 'start', method: String(options.method ?? 'GET') });
             const response = await fetcher(fullUrl, options);
             if (!response.ok) {
                 store.set(`/${loadingPath}`, false);
                 store.set(`/${errorPath}`, { status: response.status, message: `HTTP ${response.status}` });
+                emit({ id, target, status: 'http-error', statusCode: response.status });
                 return;
             }
             const data = await response.json();
             store.set(target, data);
             store.set(`/${loadingPath}`, false);
+            emit({ id, target, status: 'success', statusCode: response.status });
         }
         catch (err) {
             store.set(`/${loadingPath}`, false);
             store.set(`/${errorPath}`, {
                 message: err instanceof Error ? err.message : 'Unknown error',
             });
+            emit({ id, target, status: 'error', message: err instanceof Error ? err.message : 'Unknown error' });
         }
     }
     /** Schedule a fetch with optional debounce. */