@volter-ai-dev/supercode-ui 0.1.65 → 0.1.67

package/embed.mjs

@@ -72,7 +72,12 @@ var EMPTY_UI_STATE = Object.freeze({
   subagentInspector: null,
   attached: null,
   owned: null,
-  attachError: null
+  attachError: null,
+  agentPackage: null,
+  contributions: Object.freeze([]),
+  agentPackageError: null,
+  agentPackageCapabilityState: null,
+  agentPackageCapabilityError: null
 });
 var ROLES = /* @__PURE__ */ new Set(["system", "user", "assistant", "tool", "reasoning", "request", "notice"]);
 var MODES = /* @__PURE__ */ new Set(["none", "control", "mirror"]);
@@ -85,6 +90,10 @@ var AUTHENTICATION_PHASES = /* @__PURE__ */ new Set(["idle", "checking", "requir
 var MAX_TOOL_FIELDS = 8;
 var MAX_TOOL_FIELD_CHARS = 800;
 var MAX_TOOL_PREVIEW_CHARS = 4e3;
+var MAX_CONTRIBUTIONS = 64;
+var MAX_CONTRIBUTION_JSON_DEPTH = 12;
+var MAX_CONTRIBUTION_COLLECTION = 100;
+var MAX_CONTRIBUTION_STRING_CHARS = 16e3;
 function record(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -117,6 +126,126 @@ function number(value, fallback = 0) {
 function nullableNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function relativeContributionPath(value) {
+  if (typeof value !== "string" || value.startsWith("/") || /^[a-z]:[\\/]/i.test(value)) return null;
+  return value.replaceAll("\\", "/").split("/").some((segment) => segment === "..") ? null : boundedString(value, 1e3);
+}
+function contributionJson(value, depth = 0, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null || typeof value === "boolean" || typeof value === "string") {
+    return typeof value === "string" ? boundedString(value, MAX_CONTRIBUTION_STRING_CHARS) : value;
+  }
+  if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+  if (depth >= MAX_CONTRIBUTION_JSON_DEPTH || !value || typeof value !== "object" || seen.has(value)) {
+    return void 0;
+  }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    const result2 = [];
+    for (const item of value.slice(0, MAX_CONTRIBUTION_COLLECTION)) {
+      const normalized = contributionJson(item, depth + 1, seen);
+      if (normalized !== void 0) result2.push(normalized);
+    }
+    seen.delete(value);
+    return result2;
+  }
+  const source = record(value);
+  if (!source) return void 0;
+  const result = {};
+  for (const [key, item] of Object.entries(source).slice(0, MAX_CONTRIBUTION_COLLECTION)) {
+    const normalized = contributionJson(item, depth + 1, seen);
+    if (normalized !== void 0) result[boundedString(key, 200)] = normalized;
+  }
+  seen.delete(value);
+  return result;
+}
+function normalizeContributions(value) {
+  if (!Array.isArray(value)) return [];
+  return value.slice(0, MAX_CONTRIBUTIONS).flatMap((candidate) => {
+    const item = record(candidate);
+    const placement = record(item?.placement);
+    const source = relativeContributionPath(item?.source);
+    if (item?.schema !== "supercode/contribution-v1" || typeof item.id !== "string" || !item.id.trim() || typeof item.kind !== "string" || !item.kind.trim() || source === null) return [];
+    const data = contributionJson(item.data);
+    if (data === void 0) return [];
+    return [{
+      schema: "supercode/contribution-v1",
+      id: boundedString(item.id, 200),
+      kind: boundedString(item.kind, 100),
+      ...typeof item.title === "string" ? { title: boundedString(item.title, 500) } : {},
+      ...placement ? { placement: {
+        ...typeof placement.surface === "string" ? { surface: boundedString(placement.surface, 100) } : {},
+        ...typeof placement.region === "string" ? { region: boundedString(placement.region, 100) } : {}
+      } } : {},
+      data,
+      source
+    }];
+  });
+}
+function readAgentPackage(value) {
+  const agentPackage = record(value);
+  const capabilities = record(agentPackage?.capabilities);
+  const storage = record(agentPackage?.storage);
+  const relativePath = relativeContributionPath(storage?.relativePath);
+  if (agentPackage?.schemaVersion !== 1 || typeof agentPackage.id !== "string" || typeof agentPackage.name !== "string" || typeof agentPackage.version !== "string" || !capabilities || !Array.isArray(capabilities.required) || !Array.isArray(capabilities.optional) || !storage || relativePath === null) return null;
+  const resources = record(agentPackage.resources);
+  return {
+    id: boundedString(agentPackage.id, 200),
+    name: boundedString(agentPackage.name, 500),
+    version: boundedString(agentPackage.version, 100),
+    description: typeof agentPackage.description === "string" ? boundedString(agentPackage.description, 2e3) : null,
+    capabilities: {
+      required: capabilities.required.filter((item) => typeof item === "string").slice(0, 100).map((item) => boundedString(item, 200)),
+      optional: capabilities.optional.filter((item) => typeof item === "string").slice(0, 100).map((item) => boundedString(item, 200))
+    },
+    storage: { relativePath },
+    resources: resources ? Object.fromEntries(Object.entries(resources).flatMap(([id, candidate]) => {
+      const state = record(candidate);
+      if (state?.schema !== "supercode/package-resource-state-v1") return [];
+      if (state.status === "absent" && typeof state.contributionId === "string") {
+        return [[boundedString(id, 200), {
+          schema: "supercode/package-resource-state-v1",
+          status: "absent",
+          contributionId: boundedString(state.contributionId, 200)
+        }]];
+      }
+      if (state.status === "error" && typeof state.contributionId === "string" && typeof state.message === "string") {
+        return [[boundedString(id, 200), {
+          schema: "supercode/package-resource-state-v1",
+          status: "error",
+          contributionId: boundedString(state.contributionId, 200),
+          message: boundedString(state.message)
+        }]];
+      }
+      const resource = record(state?.resource);
+      const data = contributionJson(resource?.data);
+      if (state?.status !== "ready" || resource?.schema !== "supercode/package-resource-v1" || typeof resource.contributionId !== "string" || !["json", "text"].includes(resource.format) || typeof resource.mediaType !== "string" || data === void 0) return [];
+      return [[boundedString(id, 200), {
+        schema: "supercode/package-resource-state-v1",
+        status: "ready",
+        resource: {
+          schema: "supercode/package-resource-v1",
+          contributionId: boundedString(resource.contributionId, 200),
+          format: resource.format,
+          mediaType: boundedString(resource.mediaType, 200),
+          data
+        }
+      }]];
+    })) : {}
+  };
+}
+function readAgentPackageCapabilityState(value) {
+  const state = record(value);
+  if (!state) return null;
+  const fields = ["availableRequired", "missingRequired", "enabledOptional", "unavailableOptional"];
+  if (!fields.every((field) => Array.isArray(state[field]))) return null;
+  return {
+    ready: state.ready === true,
+    ...Object.fromEntries(fields.map((field) => [
+      field,
+      state[field].filter((item) => typeof item === "string").slice(0, 100).map((item) => boundedString(item, 200))
+    ]))
+  };
+}
 function relativeAge(updatedAt, now = Date.now()) {
   if (typeof updatedAt !== "number" || !Number.isFinite(updatedAt) || updatedAt <= 0) return "";
   const delta = Math.max(0, now - updatedAt);
@@ -834,7 +963,12 @@ function normalizeUiState(value) {
     subagentInspector: readSubagentInspector(raw.subagentInspector),
     attached: readAttached(raw.attached),
     owned: readAttached(raw.owned),
-    attachError: attachError && typeof attachError.key === "string" && typeof attachError.message === "string" ? { key: attachError.key, message: attachError.message } : null
+    attachError: attachError && typeof attachError.key === "string" && typeof attachError.message === "string" ? { key: attachError.key, message: attachError.message } : null,
+    agentPackage: readAgentPackage(raw.agentPackage),
+    contributions: normalizeContributions(raw.contributions),
+    agentPackageError: typeof raw.agentPackageError === "string" ? boundedString(raw.agentPackageError) : null,
+    agentPackageCapabilityState: readAgentPackageCapabilityState(raw.agentPackageCapabilityState),
+    agentPackageCapabilityError: typeof raw.agentPackageCapabilityError === "string" ? boundedString(raw.agentPackageCapabilityError) : null
   };
 }
 function harnessDisplayName(id) {

package/host.d.ts

@@ -109,6 +109,35 @@ export function createNativeSessionAttentionTracker(options?: {
   onChange?(state: NativeSessionAttentionTrackerState): void;
 }): NativeSessionAttentionTracker;
 
+export interface NativeMessengerStateSnapshot extends NativeSessionAttentionTrackerState {
+  drafts: Record<string, string>;
+  preferredLaunchModes: Record<string, 'headless' | 'terminal'>;
+}
+
+export function normalizeNativeMessengerState(value: unknown): NativeMessengerStateSnapshot;
+
+export class NativeMessengerState {
+  constructor(options?: {
+    state?: unknown;
+    onChange?(state: NativeMessengerStateSnapshot): void;
+  });
+  acknowledge(key: string): boolean;
+  observeAttention(options: NativeSessionAttentionObservation): {
+    attention: import('./index.js').SessionAttention[];
+    settleAfterMs: number | null;
+  };
+  draft(key: string): string;
+  setDraft(key: string, draft: string): boolean;
+  preferredLaunchMode(harness: string): 'headless' | 'terminal' | null;
+  setPreferredLaunchMode(harness: string, mode: 'headless' | 'terminal'): boolean;
+  snapshot(): NativeMessengerStateSnapshot;
+}
+
+export function createNativeMessengerState(options?: {
+  state?: unknown;
+  onChange?(state: NativeMessengerStateSnapshot): void;
+}): NativeMessengerState;
+
 export interface RemoteUiBindingOptions
   extends Pick<
     UiAdapter,

package/host.mjs

@@ -3,11 +3,18 @@ import { dispatchControllerIntent, projectClientSnapshot } from './controller.mj
 import { conversationPreviewText } from '@volter-ai-dev/supercode-client';
 
 const FRAME_SCHEMA = 'supercode.ui-host-state.v1';
+const NATIVE_STATE_LIMIT = 500;
 
 function objectRecord(value) {
   return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
 }
 
+function setRecentBounded(map, key, value) {
+  map.delete(key);
+  map.set(key, value);
+  while (map.size > NATIVE_STATE_LIMIT) map.delete(map.keys().next().value);
+}
+
 function defaultInstanceId() {
   if (typeof globalThis.crypto?.randomUUID === 'function') return globalThis.crypto.randomUUID();
   return `host-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
@@ -325,10 +332,12 @@ export function createSessionAttentionTracker(options) {
 function nativeAttentionState(value) {
   const parsed = objectRecord(value);
   const attention = Array.isArray(parsed?.attention)
-    ? parsed.attention.slice(0, 500).flatMap((candidate) => {
+    ? parsed.attention.slice(0, NATIVE_STATE_LIMIT).flatMap((candidate) => {
         const item = objectRecord(candidate);
         if (
           typeof item?.key !== 'string' ||
+          !item.key ||
+          item.key.length > 200 ||
           !['unseen', 'finished', 'failed'].includes(item.kind)
         ) return [];
         return [{
@@ -349,7 +358,7 @@ function nativeAttentionState(value) {
   const cursors = objectRecord(parsed?.observedCursors);
   const observedCursors = cursors
     ? Object.fromEntries(
-        Object.entries(cursors).slice(0, 500).filter(
+        Object.entries(cursors).slice(0, NATIVE_STATE_LIMIT).filter(
           ([key, cursor]) => key.length <= 200 && typeof cursor === 'string' && cursor.length <= 200,
         ),
       )
@@ -434,7 +443,7 @@ export class NativeSessionAttentionTracker {
             runtimeStatus: row.runtimeStatus,
           });
           if (current.cursor !== null) {
-            this.#observedCursors.set(row.key, current.cursor);
+            setRecentBounded(this.#observedCursors, row.key, current.cursor);
             changed = true;
           }
           continue;
@@ -468,7 +477,7 @@ export class NativeSessionAttentionTracker {
       }
 
       if (prior.cursor !== null && this.#observedCursors.get(row.key) !== prior.cursor) {
-        this.#observedCursors.set(row.key, prior.cursor);
+        setRecentBounded(this.#observedCursors, row.key, prior.cursor);
         changed = true;
       }
       this.#observedUpdates.set(row.key, {
@@ -549,7 +558,7 @@ export class NativeSessionAttentionTracker {
       ...(boundedPreview ? { preview: boundedPreview } : {}),
     };
     if (JSON.stringify(prior) === JSON.stringify(next)) return false;
-    this.#attention.set(key, next);
+    setRecentBounded(this.#attention, key, next);
     return true;
   }
 
@@ -562,6 +571,120 @@ export function createNativeSessionAttentionTracker(options) {
   return new NativeSessionAttentionTracker(options);
 }
 
+export function normalizeNativeMessengerState(value) {
+  const parsed = objectRecord(value);
+  const attention = nativeAttentionState(parsed);
+  const draftRecord = objectRecord(parsed?.drafts);
+  const drafts = draftRecord
+    ? Object.fromEntries(
+        Object.entries(draftRecord).slice(0, NATIVE_STATE_LIMIT).flatMap(([key, draft]) =>
+          key && key.length <= 200 && typeof draft === 'string' && draft
+            ? [[key, draft.slice(0, 50_000)]]
+            : [],
+        ),
+      )
+    : {};
+  const modeRecord = objectRecord(parsed?.preferredLaunchModes);
+  const preferredLaunchModes = modeRecord
+    ? Object.fromEntries(
+        Object.entries(modeRecord).slice(0, NATIVE_STATE_LIMIT).filter(
+          ([key, mode]) =>
+            key && key.length <= 200 && (mode === 'headless' || mode === 'terminal'),
+        ),
+      )
+    : {};
+  return {
+    version: 1,
+    attention: attention.attention,
+    observedCursors: attention.observedCursors,
+    drafts,
+    preferredLaunchModes,
+  };
+}
+
+/** One serializable, bounded state owner for native-session messenger chrome. Storage location,
+ * encryption, debounce, and multi-device synchronization remain host policy. */
+export class NativeMessengerState {
+  #attention;
+  #drafts;
+  #onChange;
+  #preferredLaunchModes;
+
+  constructor(options = {}) {
+    const state = normalizeNativeMessengerState(options.state);
+    this.#onChange = options.onChange;
+    this.#drafts = new Map(Object.entries(state.drafts));
+    this.#preferredLaunchModes = new Map(Object.entries(state.preferredLaunchModes));
+    this.#attention = new NativeSessionAttentionTracker({
+      state,
+      onChange: () => this.#emit(),
+    });
+  }
+
+  observeAttention(options) {
+    return this.#attention.observe(options);
+  }
+
+  acknowledge(key) {
+    return this.#attention.acknowledge(key);
+  }
+
+  draft(key) {
+    return this.#drafts.get(key) ?? '';
+  }
+
+  setDraft(key, draft) {
+    if (typeof key !== 'string' || !key || key.length > 200 || typeof draft !== 'string') {
+      throw new TypeError('NativeMessengerState draft needs a bounded key and string value.');
+    }
+    const next = draft.slice(0, 50_000);
+    const previous = this.#drafts.get(key) ?? '';
+    if (previous === next) return false;
+    if (next) setRecentBounded(this.#drafts, key, next);
+    else this.#drafts.delete(key);
+    this.#emit();
+    return true;
+  }
+
+  preferredLaunchMode(harness) {
+    return this.#preferredLaunchModes.get(harness) ?? null;
+  }
+
+  setPreferredLaunchMode(harness, mode) {
+    if (
+      typeof harness !== 'string' ||
+      !harness ||
+      harness.length > 200 ||
+      (mode !== 'headless' && mode !== 'terminal')
+    ) {
+      throw new TypeError('NativeMessengerState launch preference must be headless or terminal.');
+    }
+    if (this.#preferredLaunchModes.get(harness) === mode) return false;
+    setRecentBounded(this.#preferredLaunchModes, harness, mode);
+    this.#emit();
+    return true;
+  }
+
+  snapshot() {
+    const attention = this.#attention.snapshot();
+    return {
+      version: 1,
+      attention: attention.attention,
+      observedCursors: attention.observedCursors,
+      drafts: Object.fromEntries(this.#drafts),
+      preferredLaunchModes: Object.fromEntries(this.#preferredLaunchModes),
+    };
+  }
+
+  #emit() {
+    this.#onChange?.(this.snapshot());
+  }
+}
+
+export function createNativeMessengerState(options) {
+  return new NativeMessengerState(options);
+}
+
 /** Browser binding for any transport that can post one intent and return an
  * optional authoritative frame. Local host actions may intercept an intent. */
 export function createRemoteUiBinding(options) {

package/index.d.ts

@@ -10,6 +10,51 @@ export type ExecutionMode = 'headless' | 'terminal';
 export type ContinuationMode = ExecutionMode;
 export type SessionActivity = 'idle' | 'recent' | 'running' | 'working' | 'needs-input' | 'finished' | 'failed' | 'unseen';
 
+export type ContributionJson = null | boolean | number | string | ContributionJson[] | { [key: string]: ContributionJson };
+
+export interface AgentContributionModel {
+  schema: 'supercode/contribution-v1';
+  id: string;
+  kind: string;
+  title?: string;
+  placement?: { surface?: string; region?: string };
+  data: ContributionJson;
+  /** Workspace-relative declaration path; never an absolute host path. */
+  source: string;
+}
+
+export interface AgentPackageModel {
+  id: string;
+  name: string;
+  version: string;
+  description: string | null;
+  capabilities: { required: string[]; optional: string[] };
+  /** Workspace-relative durable data location. */
+  storage: { relativePath: string };
+  resources: Record<string, AgentPackageResourceStateModel>;
+}
+
+export interface AgentPackageResourceModel {
+  schema: 'supercode/package-resource-v1';
+  contributionId: string;
+  format: 'json' | 'text';
+  mediaType: string;
+  data: ContributionJson;
+}
+
+export type AgentPackageResourceStateModel =
+  | { schema: 'supercode/package-resource-state-v1'; status: 'ready'; resource: AgentPackageResourceModel }
+  | { schema: 'supercode/package-resource-state-v1'; status: 'absent'; contributionId: string }
+  | { schema: 'supercode/package-resource-state-v1'; status: 'error'; contributionId: string; message: string };
+
+export interface AgentPackageCapabilityStateModel {
+  ready: boolean;
+  availableRequired: string[];
+  missingRequired: string[];
+  enabledOptional: string[];
+  unavailableOptional: string[];
+}
+
 export interface AgentActivityModel {
   harness: HarnessId | '';
   sessionKey: string | null;
@@ -347,6 +392,12 @@ export interface SupercodeUiState {
   attached: AttachedSessionModel | null;
   owned: AttachedSessionModel | null;
   attachError: { key: string; message: string } | null;
+  /** Browser-safe package metadata; host filesystem paths are deliberately omitted. */
+  agentPackage: AgentPackageModel | null;
+  contributions: AgentContributionModel[];
+  agentPackageError: string | null;
+  agentPackageCapabilityState: AgentPackageCapabilityStateModel | null;
+  agentPackageCapabilityError: string | null;
 }
 
 export type SupercodeUiIntent =
@@ -561,6 +612,11 @@ export interface MessengerProps {
 export const EMPTY_UI_STATE: Readonly<SupercodeUiState>;
 export const DEFAULT_LABELS: Readonly<MessengerLabels>;
 export function normalizeUiState(value: unknown): SupercodeUiState;
+export function normalizeContributions(value: unknown): AgentContributionModel[];
+export function selectContributions(
+  contributions: unknown,
+  query?: { kind?: string; surface?: string; region?: string },
+): AgentContributionModel[];
 export function harnessDisplayName(id: string): string;
 export function sessionDisplayName(session: Pick<SessionRowModel, 'name' | 'title'>): string;
 export function relativeAge(updatedAt: number | null | undefined, now?: number): string;

package/messenger.mjs

@@ -69,7 +69,12 @@ var EMPTY_UI_STATE = Object.freeze({
   subagentInspector: null,
   attached: null,
   owned: null,
-  attachError: null
+  attachError: null,
+  agentPackage: null,
+  contributions: Object.freeze([]),
+  agentPackageError: null,
+  agentPackageCapabilityState: null,
+  agentPackageCapabilityError: null
 });
 var ROLES = /* @__PURE__ */ new Set(["system", "user", "assistant", "tool", "reasoning", "request", "notice"]);
 var MODES = /* @__PURE__ */ new Set(["none", "control", "mirror"]);
@@ -82,6 +87,10 @@ var AUTHENTICATION_PHASES = /* @__PURE__ */ new Set(["idle", "checking", "requir
 var MAX_TOOL_FIELDS = 8;
 var MAX_TOOL_FIELD_CHARS = 800;
 var MAX_TOOL_PREVIEW_CHARS = 4e3;
+var MAX_CONTRIBUTIONS = 64;
+var MAX_CONTRIBUTION_JSON_DEPTH = 12;
+var MAX_CONTRIBUTION_COLLECTION = 100;
+var MAX_CONTRIBUTION_STRING_CHARS = 16e3;
 function record(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
@@ -114,6 +123,126 @@ function number(value, fallback = 0) {
 function nullableNumber(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
+function relativeContributionPath(value) {
+  if (typeof value !== "string" || value.startsWith("/") || /^[a-z]:[\\/]/i.test(value)) return null;
+  return value.replaceAll("\\", "/").split("/").some((segment) => segment === "..") ? null : boundedString(value, 1e3);
+}
+function contributionJson(value, depth = 0, seen = /* @__PURE__ */ new WeakSet()) {
+  if (value === null || typeof value === "boolean" || typeof value === "string") {
+    return typeof value === "string" ? boundedString(value, MAX_CONTRIBUTION_STRING_CHARS) : value;
+  }
+  if (typeof value === "number") return Number.isFinite(value) ? value : void 0;
+  if (depth >= MAX_CONTRIBUTION_JSON_DEPTH || !value || typeof value !== "object" || seen.has(value)) {
+    return void 0;
+  }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    const result2 = [];
+    for (const item of value.slice(0, MAX_CONTRIBUTION_COLLECTION)) {
+      const normalized = contributionJson(item, depth + 1, seen);
+      if (normalized !== void 0) result2.push(normalized);
+    }
+    seen.delete(value);
+    return result2;
+  }
+  const source = record(value);
+  if (!source) return void 0;
+  const result = {};
+  for (const [key, item] of Object.entries(source).slice(0, MAX_CONTRIBUTION_COLLECTION)) {
+    const normalized = contributionJson(item, depth + 1, seen);
+    if (normalized !== void 0) result[boundedString(key, 200)] = normalized;
+  }
+  seen.delete(value);
+  return result;
+}
+function normalizeContributions(value) {
+  if (!Array.isArray(value)) return [];
+  return value.slice(0, MAX_CONTRIBUTIONS).flatMap((candidate) => {
+    const item = record(candidate);
+    const placement = record(item?.placement);
+    const source = relativeContributionPath(item?.source);
+    if (item?.schema !== "supercode/contribution-v1" || typeof item.id !== "string" || !item.id.trim() || typeof item.kind !== "string" || !item.kind.trim() || source === null) return [];
+    const data = contributionJson(item.data);
+    if (data === void 0) return [];
+    return [{
+      schema: "supercode/contribution-v1",
+      id: boundedString(item.id, 200),
+      kind: boundedString(item.kind, 100),
+      ...typeof item.title === "string" ? { title: boundedString(item.title, 500) } : {},
+      ...placement ? { placement: {
+        ...typeof placement.surface === "string" ? { surface: boundedString(placement.surface, 100) } : {},
+        ...typeof placement.region === "string" ? { region: boundedString(placement.region, 100) } : {}
+      } } : {},
+      data,
+      source
+    }];
+  });
+}
+function readAgentPackage(value) {
+  const agentPackage = record(value);
+  const capabilities = record(agentPackage?.capabilities);
+  const storage = record(agentPackage?.storage);
+  const relativePath = relativeContributionPath(storage?.relativePath);
+  if (agentPackage?.schemaVersion !== 1 || typeof agentPackage.id !== "string" || typeof agentPackage.name !== "string" || typeof agentPackage.version !== "string" || !capabilities || !Array.isArray(capabilities.required) || !Array.isArray(capabilities.optional) || !storage || relativePath === null) return null;
+  const resources = record(agentPackage.resources);
+  return {
+    id: boundedString(agentPackage.id, 200),
+    name: boundedString(agentPackage.name, 500),
+    version: boundedString(agentPackage.version, 100),
+    description: typeof agentPackage.description === "string" ? boundedString(agentPackage.description, 2e3) : null,
+    capabilities: {
+      required: capabilities.required.filter((item) => typeof item === "string").slice(0, 100).map((item) => boundedString(item, 200)),
+      optional: capabilities.optional.filter((item) => typeof item === "string").slice(0, 100).map((item) => boundedString(item, 200))
+    },
+    storage: { relativePath },
+    resources: resources ? Object.fromEntries(Object.entries(resources).flatMap(([id, candidate]) => {
+      const state = record(candidate);
+      if (state?.schema !== "supercode/package-resource-state-v1") return [];
+      if (state.status === "absent" && typeof state.contributionId === "string") {
+        return [[boundedString(id, 200), {
+          schema: "supercode/package-resource-state-v1",
+          status: "absent",
+          contributionId: boundedString(state.contributionId, 200)
+        }]];
+      }
+      if (state.status === "error" && typeof state.contributionId === "string" && typeof state.message === "string") {
+        return [[boundedString(id, 200), {
+          schema: "supercode/package-resource-state-v1",
+          status: "error",
+          contributionId: boundedString(state.contributionId, 200),
+          message: boundedString(state.message)
+        }]];
+      }
+      const resource = record(state?.resource);
+      const data = contributionJson(resource?.data);
+      if (state?.status !== "ready" || resource?.schema !== "supercode/package-resource-v1" || typeof resource.contributionId !== "string" || !["json", "text"].includes(resource.format) || typeof resource.mediaType !== "string" || data === void 0) return [];
+      return [[boundedString(id, 200), {
+        schema: "supercode/package-resource-state-v1",
+        status: "ready",
+        resource: {
+          schema: "supercode/package-resource-v1",
+          contributionId: boundedString(resource.contributionId, 200),
+          format: resource.format,
+          mediaType: boundedString(resource.mediaType, 200),
+          data
+        }
+      }]];
+    })) : {}
+  };
+}
+function readAgentPackageCapabilityState(value) {
+  const state = record(value);
+  if (!state) return null;
+  const fields = ["availableRequired", "missingRequired", "enabledOptional", "unavailableOptional"];
+  if (!fields.every((field) => Array.isArray(state[field]))) return null;
+  return {
+    ready: state.ready === true,
+    ...Object.fromEntries(fields.map((field) => [
+      field,
+      state[field].filter((item) => typeof item === "string").slice(0, 100).map((item) => boundedString(item, 200))
+    ]))
+  };
+}
 function relativeAge(updatedAt, now = Date.now()) {
   if (typeof updatedAt !== "number" || !Number.isFinite(updatedAt) || updatedAt <= 0) return "";
   const delta = Math.max(0, now - updatedAt);
@@ -831,7 +960,12 @@ function normalizeUiState(value) {
     subagentInspector: readSubagentInspector(raw.subagentInspector),
     attached: readAttached(raw.attached),
     owned: readAttached(raw.owned),
-    attachError: attachError && typeof attachError.key === "string" && typeof attachError.message === "string" ? { key: attachError.key, message: attachError.message } : null
+    attachError: attachError && typeof attachError.key === "string" && typeof attachError.message === "string" ? { key: attachError.key, message: attachError.message } : null,
+    agentPackage: readAgentPackage(raw.agentPackage),
+    contributions: normalizeContributions(raw.contributions),
+    agentPackageError: typeof raw.agentPackageError === "string" ? boundedString(raw.agentPackageError) : null,
+    agentPackageCapabilityState: readAgentPackageCapabilityState(raw.agentPackageCapabilityState),
+    agentPackageCapabilityError: typeof raw.agentPackageCapabilityError === "string" ? boundedString(raw.agentPackageCapabilityError) : null
   };
 }
 function harnessDisplayName(id) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@volter-ai-dev/supercode-ui",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "type": "module",
   "description": "Composable default UI kit for Supercode-powered coding-agent experiences",
   "exports": {