@vurb/core 3.2.3 → 3.3.4

package/dist/presenter/definePresenter.js

@@ -94,6 +94,116 @@ export function definePresenter(config) {
     if (config.redactPII) {
         presenter.redactPII(config.redactPII.paths, config.redactPII.censor);
     }
+    if (config.collectionSuggestions) {
+        presenter.collectionSuggestActions(config.collectionSuggestions);
+    }
+    if (config.collectionRules) {
+        presenter.collectionRules(config.collectionRules);
+    }
+    // Async callbacks
+    if (config.asyncUi) {
+        presenter.asyncUiBlocks(config.asyncUi);
+    }
+    if (config.asyncCollectionUi) {
+        presenter.asyncCollectionUiBlocks(config.asyncCollectionUi);
+    }
+    if (config.asyncRules) {
+        presenter.asyncRules(config.asyncRules);
+    }
+    if (config.asyncSuggestActions) {
+        presenter.asyncSuggestActions(config.asyncSuggestActions);
+    }
     return presenter;
 }
+/**
+ * Implementation
+ * @internal
+ */
+export function extendPresenter(base, overrides) {
+    const merged = {
+        // Name and schema: override always wins
+        name: overrides.name,
+        // Auto-rules: override wins when explicitly set
+        autoRules: overrides.autoRules ?? base.autoRules,
+        // Rules: merge strategy
+        rules: _mergeRules(base.rules, overrides.rules),
+        // UI: override wins if defined
+        ui: overrides.ui ?? base.ui,
+        collectionUi: overrides.collectionUi ?? base.collectionUi,
+        // Agent limit: override wins if defined
+        agentLimit: overrides.agentLimit ?? base.agentLimit,
+        // Suggestions: override wins if defined
+        suggestActions: overrides.suggestActions ?? base.suggestActions,
+        collectionSuggestions: overrides.collectionSuggestions ?? base.collectionSuggestions,
+        // Collection rules: override wins if defined
+        collectionRules: overrides.collectionRules ?? base.collectionRules,
+        // Embeds: merge (additive)
+        embeds: [
+            ...(base.embeds ?? []),
+            ...(overrides.embeds ?? []),
+        ],
+        // Redaction: merge paths
+        redactPII: _mergeRedactPII(base.redactPII, overrides.redactPII),
+        // Async callbacks: override wins if defined
+        asyncUi: overrides.asyncUi ?? base.asyncUi,
+        asyncCollectionUi: overrides.asyncCollectionUi ?? base.asyncCollectionUi,
+        asyncRules: overrides.asyncRules ?? base.asyncRules,
+        asyncSuggestActions: overrides.asyncSuggestActions ?? base.asyncSuggestActions,
+    };
+    // Schema: override wins, set only if defined (exactOptionalPropertyTypes)
+    const schema = overrides.schema ?? base.schema;
+    if (schema)
+        merged['schema'] = schema;
+    // Remove undefined values to satisfy exactOptionalPropertyTypes
+    for (const key of Object.keys(merged)) {
+        if (merged[key] === undefined)
+            delete merged[key];
+    }
+    return definePresenter(merged);
+}
+/**
+ * Merge two rules configs: static arrays are concatenated, dynamic functions are chained.
+ * @internal
+ */
+function _mergeRules(base, override) {
+    if (!base)
+        return override;
+    if (!override)
+        return base;
+    const baseIsStatic = typeof base !== 'function';
+    const overrideIsStatic = typeof override !== 'function';
+    // Both static: concatenate
+    if (baseIsStatic && overrideIsStatic) {
+        return [...base, ...override];
+    }
+    // Mix or both dynamic: chain
+    const baseFn = baseIsStatic
+        ? () => [...base]
+        : base;
+    const overrideFn = overrideIsStatic
+        ? () => [...override]
+        : override;
+    return (data, ctx) => [
+        ...baseFn(data, ctx),
+        ...overrideFn(data, ctx),
+    ];
+}
+/**
+ * Merge two redactPII configurations by concatenating paths.
+ * The override's censor function takes priority.
+ * @internal
+ */
+function _mergeRedactPII(base, override) {
+    if (!base)
+        return override;
+    if (!override)
+        return base;
+    const result = {
+        paths: [...base.paths, ...override.paths],
+    };
+    const censor = override.censor ?? base.censor;
+    if (censor !== undefined)
+        result.censor = censor;
+    return result;
+}
 //# sourceMappingURL=definePresenter.js.map

package/dist/presenter/definePresenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"definePresenter.js","sourceRoot":"","sources":["../../src/presenter/definePresenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAgB,MAAM,KAAK,CAAC;AACnC,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAgB,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AA+KtE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAgC;IAC5D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAU,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,iEAAiE;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,gBAAgB;IAC9D,MAAM,eAAe,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC;QAChD,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACrC,mDAAmD;YACnD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC/B,SAAS,CAAC,WAAW,CAAC,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE,CAAC;oBACpD,GAAG,eAAe;oBAClB,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;iBAC1B,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,KAA4D,CAAC,CAAC;YAC/F,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,6CAA6C;YAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACrD,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;SAAM,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,iDAAiD;QACjD,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACZ,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACtB,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpB,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}
+{"version":3,"file":"definePresenter.js","sourceRoot":"","sources":["../../src/presenter/definePresenter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAgB,MAAM,KAAK,CAAC;AACnC,OAAO,EAAE,SAAS,EAAyB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAgB,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAiPtE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAgC;IAC5D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAU,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,iEAAiE;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,gBAAgB;IAC9D,MAAM,eAAe,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC;QAChD,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACrC,mDAAmD;YACnD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC/B,SAAS,CAAC,WAAW,CAAC,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE,CAAC;oBACpD,GAAG,eAAe;oBAClB,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC;iBAC1B,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,KAA4D,CAAC,CAAC;YAC/F,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,6CAA6C;YAC7C,MAAM,MAAM,GAAG,CAAC,GAAG,eAAe,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACrD,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;SAAM,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,iDAAiD;QACjD,SAAS,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACZ,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACtB,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpB,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;QAC/B,SAAS,CAAC,wBAAwB,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACrE,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACzB,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACtD,CAAC;IAED,kBAAkB;IAClB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,OAAwE,CAAC,CAAC;IAC7G,CAAC;IACD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC3B,SAAS,CAAC,uBAAuB,CAAC,MAAM,CAAC,iBAAqF,CAAC,CAAC;IACpI,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpB,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,UAA0E,CAAC,CAAC;IAC5G,CAAC;IACD,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC7B,SAAS,CAAC,mBAAmB,CAAC,MAAM,CAAC,mBAA6F,CAAC,CAAC;IACxI,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AA6DD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC3B,IAAuC,EACvC,SAA+D;IAE/D,MAAM,MAAM,GAA4B;QACpC,wCAAwC;QACxC,IAAI,EAAE,SAAS,CAAC,IAAI;QAEpB,gDAAgD;QAChD,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;QAEhD,wBAAwB;QACxB,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;QAE/C,+BAA+B;QAC/B,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE;QAC3B,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY;QAEzD,wCAAwC;QACxC,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;QAEnD,wCAAwC;QACxC,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc;QAC/D,qBAAqB,EAAE,SAAS,CAAC,qBAAqB,IAAI,IAAI,CAAC,qBAAqB;QAEpF,6CAA6C;QAC7C,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe;QAElE,2BAA2B;QAC3B,MAAM,EAAE;YACJ,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YACtB,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC;SAC9B;QAED,yBAAyB;QACzB,SAAS,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC;QAE/D,4CAA4C;QAC5C,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;QAC1C,iBAAiB,EAAE,SAAS,CAAC,iBAAiB,IAAI,IAAI,CAAC,iBAAiB;QACxE,UAAU,EAAE,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU;QACnD,mBAAmB,EAAE,SAAS,CAAC,mBAAmB,IAAI,IAAI,CAAC,mBAAmB;KACjF,CAAC;IAEF,0EAA0E;IAC1E,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAC/C,IAAI,MAAM;QAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;IAEtC,gEAAgE;IAChE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,eAAe,CAAC,MAA+D,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAChB,IAAwC,EACxC,QAA4C;IAE5C,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,YAAY,GAAG,OAAO,IAAI,KAAK,UAAU,CAAC;IAChD,MAAM,gBAAgB,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC;IAExD,2BAA2B;IAC3B,IAAI,YAAY,IAAI,gBAAgB,EAAE,CAAC;QACnC,OAAO,CAAC,GAAI,IAA0B,EAAE,GAAI,QAA8B,CAAC,CAAC;IAChF,CAAC;IAED,6BAA6B;IAC7B,MAAM,MAAM,GAAG,YAAY;QACvB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAI,IAA0B,CAAC;QACxC,CAAC,CAAC,IAA2D,CAAC;IAClE,MAAM,UAAU,GAAG,gBAAgB;QAC/B,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAI,QAA8B,CAAC;QAC5C,CAAC,CAAC,QAA+D,CAAC;IAEtE,OAAO,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE,CAAC;QACrC,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC;QACpB,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;KAC3B,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CACpB,IAA4C,EAC5C,QAAgD;IAEhD,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,MAAM,GAAwE;QAChF,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC;KAC5C,CAAC;IACF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAC9C,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACjD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/presenter/index.d.ts

@@ -6,9 +6,9 @@
 export { ResponseBuilder, response, isResponseBuilder } from './ResponseBuilder.js';
 export type { ActionSuggestion } from './ResponseBuilder.js';
 export { ui } from './ui.js';
-export type { UiBlock } from './ui.js';
+export type { UiBlock, UiBlockMeta } from './ui.js';
 export { Presenter, createPresenter, isPresenter } from './Presenter.js';
-export { definePresenter } from './definePresenter.js';
+export { definePresenter, extendPresenter } from './definePresenter.js';
 export type { PresenterConfig, AgentLimitDef, EmbedDef } from './definePresenter.js';
 export { extractZodDescriptions } from './ZodDescriptionExtractor.js';
 export { PresenterValidationError } from './PresenterValidationError.js';
@@ -18,4 +18,8 @@ export { postProcessResult, isToolResponse } from './PostProcessor.js';
 export { extractZodKeys, pickFields, applySelectFilter } from './SelectUtils.js';
 export { compileRedactor, initRedactEngine } from './RedactEngine.js';
 export type { RedactConfig, RedactFn } from './RedactEngine.js';
+export { createJudgeChain } from './JudgeChain.js';
+export type { JudgeChain, JudgeChainConfig, JudgeChainResult, JudgeResult, JudgeStrategy, } from './JudgeChain.js';
+export { evaluateRules, buildFirewallPrompt, parseFirewallVerdict } from './PromptFirewall.js';
+export type { PromptFirewallConfig, FirewallVerdict, FirewallRejection, } from './PromptFirewall.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/presenter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presenter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presenter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACpF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAGrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACR,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAC9C,WAAW,EAAE,aAAa,GAC7B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/F,YAAY,EACR,oBAAoB,EAAE,eAAe,EAAE,iBAAiB,GAC3D,MAAM,qBAAqB,CAAC"}

package/dist/presenter/index.js

@@ -10,7 +10,7 @@ export { ui } from './ui.js';
 // ── Presenter ────────────────────────────────────────────
 export { Presenter, createPresenter, isPresenter } from './Presenter.js';
 // ── Declarative Presenter ────────────────────────────────
-export { definePresenter } from './definePresenter.js';
+export { definePresenter, extendPresenter } from './definePresenter.js';
 // ── Zod Description Extraction ───────────────────────────
 export { extractZodDescriptions } from './ZodDescriptionExtractor.js';
 // ── Validation Error ─────────────────────────────────────
@@ -25,4 +25,8 @@ export { postProcessResult, isToolResponse } from './PostProcessor.js';
 export { extractZodKeys, pickFields, applySelectFilter } from './SelectUtils.js';
 // ── DLP Compliance (PII Redaction) ───────────────────────
 export { compileRedactor, initRedactEngine } from './RedactEngine.js';
+// ── JudgeChain (Multi-Adapter LLM Evaluation) ───────────
+export { createJudgeChain } from './JudgeChain.js';
+// ── PromptFirewall (Output Protection) ──────────────────
+export { evaluateRules, buildFirewallPrompt, parseFirewallVerdict } from './PromptFirewall.js';
 //# sourceMappingURL=index.js.map

package/dist/presenter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presenter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGpF,4DAA4D;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,4DAA4D;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,4DAA4D;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,4DAA4D;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAErC,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjF,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presenter/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGpF,4DAA4D;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,4DAA4D;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEzE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGxE,4DAA4D;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,4DAA4D;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,4DAA4D;AAC5D,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AAErC,4DAA4D;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE,4DAA4D;AAC5D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjF,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGtE,2DAA2D;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,2DAA2D;AAC3D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/presenter/ui.d.ts

@@ -24,6 +24,27 @@
  *
  * @module
  */
+/**
+ * Optional metadata for a UI block — layout hints and presentation context.
+ *
+ * Metadata is rendered as XML attributes on the `<ui_passthrough>` wrapper,
+ * providing downstream clients and AI agents with structured display hints
+ * without altering the content payload.
+ *
+ * @example
+ * ```typescript
+ * ui.echarts(chartConfig, { title: 'Revenue', width: 'half' });
+ * ui.table(headers, rows, { title: 'Invoices', priority: 1 });
+ * ```
+ */
+export interface UiBlockMeta {
+    /** Human-readable label for the block (e.g. chart title, section name) */
+    readonly title?: string;
+    /** Layout width hint for rendering clients */
+    readonly width?: 'full' | 'half' | 'third';
+    /** Rendering priority (lower = rendered first). Default: insertion order */
+    readonly priority?: number;
+}
 /**
  * A structured UI block produced by a Presenter's SSR layer.
  *
@@ -35,6 +56,8 @@ export interface UiBlock {
     readonly type: string;
     /** Ready-to-transport content string */
     readonly content: string;
+    /** Optional layout and presentation metadata */
+    readonly meta?: UiBlockMeta;
 }
 /**
  * Generate an ECharts UI block from a configuration object.
@@ -54,7 +77,7 @@ export interface UiBlock {
  * });
  * ```
  */
-declare function echarts(config: Record<string, unknown>): UiBlock;
+declare function echarts(config: Record<string, unknown>, meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a Mermaid diagram UI block.
  *
@@ -66,7 +89,7 @@ declare function echarts(config: Record<string, unknown>): UiBlock;
  * ui.mermaid('graph TD; A["Start"] --> B["Process"] --> C["End"]');
  * ```
  */
-declare function mermaid(diagram: string): UiBlock;
+declare function mermaid(diagram: string, meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a raw Markdown UI block.
  *
@@ -81,7 +104,7 @@ declare function mermaid(diagram: string): UiBlock;
  * ui.markdown('| Task | Status |\n|---|---|\n| Deploy | ✅ Done |');
  * ```
  */
-declare function markdown(md: string): UiBlock;
+declare function markdown(md: string, meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a generic fenced code block UI block.
  *
@@ -98,7 +121,7 @@ declare function markdown(md: string): UiBlock;
  * ui.codeBlock('xml', '<root><item>value</item></root>');
  * ```
  */
-declare function codeBlock(lang: string, code: string): UiBlock;
+declare function codeBlock(lang: string, code: string, meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a Markdown table UI block from headers and row data.
  *
@@ -121,7 +144,7 @@ declare function codeBlock(lang: string, code: string): UiBlock;
  * );
  * ```
  */
-declare function table(headers: readonly string[], rows: readonly (readonly string[])[]): UiBlock;
+declare function table(headers: readonly string[], rows: readonly (readonly string[])[], meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a Markdown bullet list UI block.
  *
@@ -136,7 +159,7 @@ declare function table(headers: readonly string[], rows: readonly (readonly stri
  * // → "- Deploy API server\n- Run database migrations\n- Verify health checks"
  * ```
  */
-declare function list(items: readonly string[]): UiBlock;
+declare function list(items: readonly string[], meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a fenced JSON code block UI block.
  *
@@ -151,7 +174,7 @@ declare function list(items: readonly string[]): UiBlock;
  * ui.json({ host: 'api.example.com', port: 3000, ssl: true });
  * ```
  */
-declare function json(data: unknown): UiBlock;
+declare function json(data: unknown, meta?: UiBlockMeta): UiBlock;
 /**
  * Generate a summary UI block for collection overviews.
  *
@@ -166,7 +189,7 @@ declare function json(data: unknown): UiBlock;
  * ui.summary('3 invoices totaling $5,700.00. 2 paid, 1 pending.');
  * ```
  */
-declare function summary(text: string): UiBlock;
+declare function summary(text: string, meta?: UiBlockMeta): UiBlock;
 /**
  * UI block helpers for Server-Side Rendering (SSR) in Presenters.
  *

package/dist/presenter/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/presenter/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAkBD;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;GAUG;AACH,iBAAS,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzC;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErC;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,KAAK,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,CAKxF;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,IAAI,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE/C;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAEpC;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtC;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,EAAE;;;;;;;;;CAKL,CAAC"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/presenter/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;CAC/B;AAkBD;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAE7E;AAED;;;;;;;;;;GAUG;AACH,iBAAS,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAE7D;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAEzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAE1E;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,KAAK,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAK5G;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,IAAI,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAExD;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAE1D;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,EAAE;;;;;;;;;CAKL,CAAC"}

package/dist/presenter/ui.js

@@ -55,8 +55,8 @@ function fence(lang, body) {
  * });
  * ```
  */
-function echarts(config) {
-    return { type: 'echarts', content: fence('echarts', JSON.stringify(config, null, 2)) };
+function echarts(config, meta) {
+    return { type: 'echarts', content: fence('echarts', JSON.stringify(config, null, 2)), ...(meta ? { meta } : {}) };
 }
 /**
  * Generate a Mermaid diagram UI block.
@@ -69,8 +69,8 @@ function echarts(config) {
  * ui.mermaid('graph TD; A["Start"] --> B["Process"] --> C["End"]');
  * ```
  */
-function mermaid(diagram) {
-    return { type: 'mermaid', content: fence('mermaid', diagram) };
+function mermaid(diagram, meta) {
+    return { type: 'mermaid', content: fence('mermaid', diagram), ...(meta ? { meta } : {}) };
 }
 /**
  * Generate a raw Markdown UI block.
@@ -86,8 +86,8 @@ function mermaid(diagram) {
  * ui.markdown('| Task | Status |\n|---|---|\n| Deploy | ✅ Done |');
  * ```
  */
-function markdown(md) {
-    return { type: 'markdown', content: md };
+function markdown(md, meta) {
+    return { type: 'markdown', content: md, ...(meta ? { meta } : {}) };
 }
 /**
  * Generate a generic fenced code block UI block.
@@ -105,8 +105,8 @@ function markdown(md) {
  * ui.codeBlock('xml', '<root><item>value</item></root>');
  * ```
  */
-function codeBlock(lang, code) {
-    return { type: lang, content: fence(lang, code) };
+function codeBlock(lang, code, meta) {
+    return { type: lang, content: fence(lang, code), ...(meta ? { meta } : {}) };
 }
 // ── DX Helpers ───────────────────────────────────────────
 /**
@@ -131,11 +131,11 @@ function codeBlock(lang, code) {
  * );
  * ```
  */
-function table(headers, rows) {
+function table(headers, rows, meta) {
     const headerRow = `| ${headers.join(' | ')} |`;
     const separator = `| ${headers.map(() => '---').join(' | ')} |`;
     const bodyRows = rows.map(row => `| ${row.join(' | ')} |`).join('\n');
-    return { type: 'markdown', content: `${headerRow}\n${separator}\n${bodyRows}` };
+    return { type: 'markdown', content: `${headerRow}\n${separator}\n${bodyRows}`, ...(meta ? { meta } : {}) };
 }
 /**
  * Generate a Markdown bullet list UI block.
@@ -151,8 +151,8 @@ function table(headers, rows) {
  * // → "- Deploy API server\n- Run database migrations\n- Verify health checks"
  * ```
  */
-function list(items) {
-    return { type: 'markdown', content: items.map(item => `- ${item}`).join('\n') };
+function list(items, meta) {
+    return { type: 'markdown', content: items.map(item => `- ${item}`).join('\n'), ...(meta ? { meta } : {}) };
 }
 /**
  * Generate a fenced JSON code block UI block.
@@ -168,8 +168,8 @@ function list(items) {
  * ui.json({ host: 'api.example.com', port: 3000, ssl: true });
  * ```
  */
-function json(data) {
-    return { type: 'json', content: fence('json', JSON.stringify(data, null, 2)) };
+function json(data, meta) {
+    return { type: 'json', content: fence('json', JSON.stringify(data, null, 2)), ...(meta ? { meta } : {}) };
 }
 /**
  * Generate a summary UI block for collection overviews.
@@ -185,8 +185,8 @@ function json(data) {
  * ui.summary('3 invoices totaling $5,700.00. 2 paid, 1 pending.');
  * ```
  */
-function summary(text) {
-    return { type: 'summary', content: `📊 **Summary**: ${text}` };
+function summary(text, meta) {
+    return { type: 'summary', content: `📊 **Summary**: ${text}`, ...(meta ? { meta } : {}) };
 }
 // ── Public Namespace ─────────────────────────────────────
 /**

package/dist/presenter/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/presenter/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAiBH,4DAA4D;AAE5D;;;;;;;GAOG;AACH,SAAS,KAAK,CAAC,IAAY,EAAE,IAAY;IACrC,OAAO,SAAS,IAAI,KAAK,IAAI,UAAU,CAAC;AAC5C,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAS,OAAO,CAAC,MAA+B;IAC5C,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,OAAO,CAAC,OAAe;IAC5B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,QAAQ,CAAC,EAAU;IACxB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IACzC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAS,KAAK,CAAC,OAA0B,EAAE,IAAoC;IAC3E,MAAM,SAAS,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC/C,MAAM,SAAS,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,KAAK,SAAS,KAAK,QAAQ,EAAE,EAAE,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,IAAI,CAAC,KAAwB;IAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,IAAI,CAAC,IAAa;IACvB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,OAAO,CAAC,IAAY;IACzB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC;AACnE,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,MAAM,EAAE,GAAG;IACd,SAAS;IACT,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS;IACrC,aAAa;IACb,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO;CACpB,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/presenter/ui.ts"],"names":[],"mappings":"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"}

package/dist/prompt/FluentPromptBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FluentPromptBuilder.d.ts","sourceRoot":"","sources":["../../src/prompt/FluentPromptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AACvD,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD;;;;;;;;;GASG;AACH,qBAAa,mBAAmB,CAAC,QAAQ,GAAG,IAAI,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC7G,YAAW,aAAa,CAAC,QAAQ,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAoC;IACnD,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,KAAK,CAAC,CAA2C;IACzD,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,CAA0E;IAE3F,+EAA+E;IAC/E,OAAO,CAAC,SAAS,CAAsC;gBAE3C,IAAI,EAAE,MAAM;IAMxB;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMnC;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMrD;;;;;OAKG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1G,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAQpC;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI;IAM3C;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAQ1F,mEAAmE;IACnE,OAAO,CAAC,MAAM;IAuBd,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,OAAO,IAAI,MAAM,EAAE;IAInB,aAAa,IAAI,OAAO;IAIxB,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC,qBAAqB;;;;;uBAQ43J,CAAC;oBAA8B,CAAC;;;IAJj7J,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CAG9E"}
+{"version":3,"file":"FluentPromptBuilder.d.ts","sourceRoot":"","sources":["../../src/prompt/FluentPromptBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AACvD,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,eAAe,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAOrD;;;;;;;;;GASG;AACH,qBAAa,mBAAmB,CAAC,QAAQ,GAAG,IAAI,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAC7G,YAAW,aAAa,CAAC,QAAQ,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAoC;IACnD,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,KAAK,CAAC,CAA2C;IACzD,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,CAA0E;IAE3F,+EAA+E;IAC/E,OAAO,CAAC,SAAS,CAAsC;gBAE3C,IAAI,EAAE,MAAM;IAMxB;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMnC;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMrD;;;;;OAKG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1G,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAQpC;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI;IAM3C;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAQ1F,mEAAmE;IACnE,OAAO,CAAC,MAAM;IAuBd,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC,OAAO,IAAI,MAAM,EAAE;IAInB,aAAa,IAAI,OAAO;IAIxB,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC,qBAAqB;;;;;uBAQihK,CAAC;oBAA+B,CAAC;;;IAJvkK,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;CAG9E"}

package/dist/resource/ResourceBuilder.d.ts

@@ -0,0 +1,129 @@
+/**
+ * ResourceBuilder — Fluent Builder for MCP Resources
+ *
+ * Provides a fluent API for defining MCP Resources that expose
+ * data to LLMs. Resources can optionally be subscribable, enabling
+ * push notifications when data changes.
+ *
+ * @example
+ * ```typescript
+ * import { defineResource } from '@vurb/core';
+ *
+ * const stockPrice = defineResource<AppContext>('stock_price', {
+ *     uri: 'stock://prices/{symbol}',
+ *     mimeType: 'application/json',
+ *     description: 'Real-time stock price for a given symbol',
+ *     subscribable: true,
+ *     handler: async (uri, ctx) => {
+ *         const symbol = uri.match(/stock:\/\/prices\/(.+)/)?.[1];
+ *         const price = await ctx.stockApi.getPrice(symbol);
+ *         return { text: JSON.stringify(price) };
+ *     },
+ * });
+ * ```
+ *
+ * @see {@link ResourceRegistry} for registration and routing
+ * @see {@link SubscriptionManager} for subscription tracking
+ *
+ * @module
+ */
+/**
+ * Content returned by a resource read handler.
+ *
+ * Mirrors the MCP `ReadResourceResult.contents[0]` shape.
+ */
+export interface ResourceContent {
+    /** Textual content of the resource (UTF-8) */
+    readonly text?: string;
+    /** Base64-encoded binary content (mutually exclusive with `text`) */
+    readonly blob?: string;
+}
+/**
+ * Handler function invoked when a client reads a resource.
+ *
+ * @param uri - The fully resolved URI requested by the client
+ * @param ctx - Application context (from contextFactory)
+ * @returns The resource content
+ */
+export type ResourceHandler<TContext> = (uri: string, ctx: TContext) => ResourceContent | Promise<ResourceContent>;
+/**
+ * Configuration for defining a resource.
+ */
+export interface ResourceConfig<TContext> {
+    /** URI or URI template (with `{placeholders}`) identifying this resource */
+    readonly uri: string;
+    /** Human-readable description shown to AI agents */
+    readonly description?: string;
+    /** MIME type of the resource content */
+    readonly mimeType?: string;
+    /** Optional tags for filtering */
+    readonly tags?: string[];
+    /** Whether AI agents can subscribe to push notifications for this resource */
+    readonly subscribable?: boolean;
+    /**
+     * MCP resource annotations for audience, priority, and freshness.
+     *
+     * @see https://spec.modelcontextprotocol.io/2025-03-26/server/resources/#resource-annotations
+     */
+    readonly annotations?: {
+        readonly audience?: Array<'user' | 'assistant'>;
+        readonly priority?: number;
+    };
+    /** Handler called when a client reads this resource */
+    readonly handler: ResourceHandler<TContext>;
+}
+/**
+ * Compiled resource definition for MCP `resources/list`.
+ */
+export interface McpResourceDef {
+    readonly uri: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly mimeType?: string;
+    readonly annotations?: {
+        readonly audience?: Array<'user' | 'assistant'>;
+        readonly priority?: number;
+    };
+}
+/**
+ * Public interface for a resource builder.
+ *
+ * Consumed by {@link ResourceRegistry} for registration and routing.
+ */
+export interface ResourceBuilder<TContext = void> {
+    /** Get the resource name (unique identifier) */
+    getName(): string;
+    /** Get the URI or URI template */
+    getUri(): string;
+    /** Get optional tags for filtering */
+    getTags(): string[];
+    /** Whether this resource supports subscriptions */
+    isSubscribable(): boolean;
+    /** Build the MCP resource definition for `resources/list` */
+    buildResourceDefinition(): McpResourceDef;
+    /** Read the resource content for a given URI */
+    read(uri: string, ctx: TContext): Promise<ResourceContent>;
+}
+/**
+ * Define a new MCP Resource.
+ *
+ * @param name - Unique resource name (used as identifier)
+ * @param config - Resource configuration
+ * @returns A resource builder for registration in {@link ResourceRegistry}
+ *
+ * @example
+ * ```typescript
+ * const deployStatus = defineResource<AppContext>('deploy_status', {
+ *     uri: 'deploy://status/{environment}',
+ *     description: 'Real-time deploy pipeline status',
+ *     subscribable: true,
+ *     handler: async (uri, ctx) => {
+ *         const env = uri.match(/deploy:\/\/status\/(.+)/)?.[1];
+ *         const status = await ctx.deployService.getStatus(env);
+ *         return { text: JSON.stringify(status) };
+ *     },
+ * });
+ * ```
+ */
+export declare function defineResource<TContext = void>(name: string, config: ResourceConfig<TContext>): ResourceBuilder<TContext>;
+//# sourceMappingURL=ResourceBuilder.d.ts.map

package/dist/resource/ResourceBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceBuilder.d.ts","sourceRoot":"","sources":["../../src/resource/ResourceBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,QAAQ,IAAI,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,QAAQ,KACZ,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,QAAQ;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE;QACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE;QACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACL;AAID;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,IAAI;IAC5C,gDAAgD;IAChD,OAAO,IAAI,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,IAAI,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,IAAI,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,cAAc,IAAI,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,uBAAuB,IAAI,cAAc,CAAC;IAC1C,gDAAgD;IAChD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9D;AAgDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAG,IAAI,EAC1C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GACjC,eAAe,CAAC,QAAQ,CAAC,CAE3B"}

package/dist/resource/ResourceBuilder.js

@@ -0,0 +1,93 @@
+/**
+ * ResourceBuilder — Fluent Builder for MCP Resources
+ *
+ * Provides a fluent API for defining MCP Resources that expose
+ * data to LLMs. Resources can optionally be subscribable, enabling
+ * push notifications when data changes.
+ *
+ * @example
+ * ```typescript
+ * import { defineResource } from '@vurb/core';
+ *
+ * const stockPrice = defineResource<AppContext>('stock_price', {
+ *     uri: 'stock://prices/{symbol}',
+ *     mimeType: 'application/json',
+ *     description: 'Real-time stock price for a given symbol',
+ *     subscribable: true,
+ *     handler: async (uri, ctx) => {
+ *         const symbol = uri.match(/stock:\/\/prices\/(.+)/)?.[1];
+ *         const price = await ctx.stockApi.getPrice(symbol);
+ *         return { text: JSON.stringify(price) };
+ *     },
+ * });
+ * ```
+ *
+ * @see {@link ResourceRegistry} for registration and routing
+ * @see {@link SubscriptionManager} for subscription tracking
+ *
+ * @module
+ */
+// ── Implementation ───────────────────────────────────────
+class ResourceBuilderImpl {
+    _name;
+    _uri;
+    _description;
+    _mimeType;
+    _tags;
+    _subscribable;
+    _annotations;
+    _handler;
+    constructor(name, config) {
+        this._name = name;
+        this._uri = config.uri;
+        this._description = config.description;
+        this._mimeType = config.mimeType ?? 'application/json';
+        this._tags = config.tags ?? [];
+        this._subscribable = config.subscribable ?? false;
+        this._annotations = config.annotations;
+        this._handler = config.handler;
+    }
+    getName() { return this._name; }
+    getUri() { return this._uri; }
+    getTags() { return this._tags; }
+    isSubscribable() { return this._subscribable; }
+    buildResourceDefinition() {
+        const def = {
+            uri: this._uri,
+            name: this._name,
+            ...(this._description ? { description: this._description } : {}),
+            ...(this._mimeType ? { mimeType: this._mimeType } : {}),
+            ...(this._annotations ? { annotations: this._annotations } : {}),
+        };
+        return def;
+    }
+    async read(uri, ctx) {
+        return this._handler(uri, ctx);
+    }
+}
+// ── Factory ──────────────────────────────────────────────
+/**
+ * Define a new MCP Resource.
+ *
+ * @param name - Unique resource name (used as identifier)
+ * @param config - Resource configuration
+ * @returns A resource builder for registration in {@link ResourceRegistry}
+ *
+ * @example
+ * ```typescript
+ * const deployStatus = defineResource<AppContext>('deploy_status', {
+ *     uri: 'deploy://status/{environment}',
+ *     description: 'Real-time deploy pipeline status',
+ *     subscribable: true,
+ *     handler: async (uri, ctx) => {
+ *         const env = uri.match(/deploy:\/\/status\/(.+)/)?.[1];
+ *         const status = await ctx.deployService.getStatus(env);
+ *         return { text: JSON.stringify(status) };
+ *     },
+ * });
+ * ```
+ */
+export function defineResource(name, config) {
+    return new ResourceBuilderImpl(name, config);
+}
+//# sourceMappingURL=ResourceBuilder.js.map