@jini-ai/ui 0.1.2 → 0.3.0

package/dist/features/execution/types.d.ts

@@ -0,0 +1,410 @@
+/**
+ * Origin: the inline `execution` tab body in `SettingsDialog.tsx`
+ * (lines 4080-5336), classified MIXED by
+ * `ADS-memory/reports/jini-port/recon/r6-god-component-internals.md` §1.3 — a generic
+ * "Local CLI vs. bring-your-own-key" execution switch wrapped in
+ * origin-specific managed-runtime/wallet chrome.
+ *
+ * What is ported: the mode switch, the provider/gateway chip groups, and the
+ * BYOK credential form (the origin had already factored these fields into
+ * `components/byok/*`, which is why this slice is assembly rather than
+ * surgery).
+ *
+ * What is deliberately left behind: the origin's managed-runtime wallet
+ * (balance polling, top-up, sign-in coachmarks, the `SettingsHighlight`
+ * one-shot focus hint) and its analytics tracking calls — all product-bound,
+ * none of it generic.
+ */
+/** `'local-cli'` runs a detected code-agent CLI on this machine; `'byok'`
+ *  talks to a model endpoint with the operator's own credentials. The origin
+ *  spelled these `'daemon'` and `'api'` — renamed here to say what they mean
+ *  rather than how the origin's transport happened to be wired. */
+export type ExecutionMode = 'local-cli' | 'byok';
+/** Wire protocol a BYOK endpoint speaks. Vendor-shaped, not product-shaped:
+ *  these name public API dialects, the same way `features/i18n` names locales. */
+export type ApiProtocol = 'anthropic' | 'openai' | 'azure' | 'google';
+/** Where a preset renders in the chip strip. The origin drew one row of
+ *  protocol presets and one of gateway presets; hosts that don't care can
+ *  leave this unset and get a single row. */
+export type ProviderPresetKind = 'protocol' | 'gateway';
+/** One selectable endpoint preset. A host supplies its own catalog — this
+ *  package ships `DEFAULT_PROVIDER_PRESETS` as a starting point, not as a
+ *  fixed list (same convention as `LanguageTab`'s host-supplied locales). */
+export interface ProviderPreset {
+    id: string;
+    title: string;
+    protocol: ApiProtocol;
+    baseUrl: string;
+    /** Ranked suggestions shown in the model field. Never authoritative — a
+     *  host with live model discovery should pass `ExecutionPort.listModels`. */
+    preferredModels: readonly string[];
+    kind?: ProviderPresetKind;
+    /** Fixed-origin gateways resolve their base URL themselves, so the Base URL
+     *  field is hidden rather than shown-and-ignored (origin: `isFixedOriginGateway`). */
+    fixedOrigin?: boolean;
+    /** Some local/self-hosted endpoints need no bearer credential. Defaults to
+     *  `true` — i.e. an API key is required unless a preset opts out. */
+    requiresApiKey?: boolean;
+    /** Optional "Get key" deep link rendered beside the API-key field. */
+    apiKeyConsoleUrl?: string;
+    /** The synthetic "Custom" preset. Exactly one may carry this flag; it is
+     *  never treated as configured-by-preset and never hides the Base URL. */
+    custom?: boolean;
+}
+/** One provider's saved credential draft — everything `ByokConfig` carries at
+ *  the top level, minus the selection fields (`protocol`/`providerId`), which
+ *  only make sense for the *active* selection. */
+export interface ByokProviderCredentials {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    maxTokens?: number | undefined;
+}
+/**
+ * The operator's BYOK credentials and endpoint selection.
+ *
+ * `apiKey`/`baseUrl`/`model`/`maxTokens` at the top level are the *active*
+ * selection's live values — what the form renders and what a connection test
+ * or real dispatch uses right now. They are NOT shared across providers:
+ * every other preset's last-saved credentials live in `savedByProviderId`,
+ * keyed by preset id, and `nextConfigForPresetSelect` (`rules.ts`) snapshots
+ * the outgoing provider into that map before loading the incoming one.
+ *
+ * Origin: `state/config.ts`'s `apiProtocolConfigs` (keyed per protocol) plus
+ * `byokProviderConfigDrafts` (keyed per protocol+baseUrl, for presets that
+ * share a protocol but not an endpoint). This package collapses both into one
+ * map keyed by preset id, which is already unique per endpoint in this tab's
+ * catalog. Without this split, every preset chip's "configured" status
+ * (`isProviderConfigured`) reads the SAME shared fields — so selecting
+ * Anthropic and typing a key made the unrelated Ollama chip (which requires
+ * no key) render "configured" too, because it was being checked against
+ * Anthropic's live base URL rather than its own.
+ */
+export interface ByokConfig {
+    protocol: ApiProtocol;
+    /** `null` selects the custom/manual endpoint rather than a preset. */
+    providerId: string | null;
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    /** Omitted/undefined means "use the model's own default", which is why this
+     *  is not `number | 0` — 0 would be a real cap of zero tokens. */
+    maxTokens?: number | undefined;
+    /** Saved credentials for every preset OTHER than the active selection,
+     *  keyed by `ProviderPreset.id`. See this interface's header. */
+    savedByProviderId?: Readonly<Record<string, ByokProviderCredentials>>;
+}
+export interface ExecutionConfig {
+    mode: ExecutionMode;
+    byok: ByokConfig;
+    localCli: LocalCliConfig;
+}
+/** One model a detected agent can be asked to run. Mirrors
+ *  `@jini-ai/agent-runtime`'s `RuntimeModelOption` field-for-field so a host
+ *  backed by that package passes its detection payload through unmapped. */
+export interface AgentModelOption {
+    id: string;
+    label: string;
+}
+/** Where an agent's model list came from. `'live'` was pulled from the CLI
+ *  itself (its config or a catalog call); `'fallback'` is the adapter's
+ *  built-in list. The distinction is rendered, not cosmetic: an operator
+ *  looking at a stale built-in list needs to know a rescan can improve it. */
+export type AgentModelSource = 'live' | 'fallback';
+/** Whether the CLI appears to be signed in. `'unknown'` is a real third state,
+ *  not a synonym for `'missing'` — an adapter with no auth probe, or a probe
+ *  that could not be classified, genuinely does not know, and saying
+ *  "authentication required" there would be a false claim. */
+export type AgentAuthStatus = 'ok' | 'missing' | 'unknown';
+/** Whether an agent's CLI accepts an operator-typed model id outside its
+ *  known `models` list. `undefined` means "allow" (most CLIs do) — a host
+ *  opts OUT with an explicit `false` for a CLI that routes model selection
+ *  through a closed catalog (no free-text `--model` flag, or a protocol that
+ *  validates the id against a live catalog and rejects unknown ones).
+ *  Origin: `RuntimeAgentDef.supportsCustomModel`. */
+export type AgentSupportsCustomModel = boolean;
+/**
+ * A code-agent CLI found on the machine that ran detection, as reported by
+ * `ExecutionPort`.
+ *
+ * Everything below `path` is optional because a host may know less than
+ * `@jini-ai/agent-runtime` does — but a host backed by that package should
+ * pass all of it through. Its `DetectedAgent` (`types.ts`, the `models` /
+ * `modelsSource` / `authStatus` / `authMessage` / `path` / `version`
+ * intersection) already carries every field here, so narrowing the payload at
+ * the route boundary throws away data the card is built to render.
+ */
+export interface DetectedAgent {
+    id: string;
+    label: string;
+    installed: boolean;
+    version?: string | undefined;
+    /** Absolute path to the resolved binary, when the host can determine it. */
+    path?: string | undefined;
+    /** One-line vendor description ("Anthropic official CLI"). Describes the
+     *  CLI, not the product embedding it — see `DEFAULT_AGENT_DESCRIPTIONS`,
+     *  which a host may extend or replace. */
+    description?: string | undefined;
+    models?: readonly AgentModelOption[] | undefined;
+    modelsSource?: AgentModelSource | undefined;
+    /** Reasoning-effort/mode presets this agent's model exposes (e.g.
+     *  "low"/"medium"/"high"), reusing `AgentModelOption`'s `{id, label}` shape
+     *  — the same shape `@jini-ai/agent-runtime`'s `RuntimeReasoningOption`
+     *  aliases from its model-option type, for the same reason: a reasoning
+     *  choice IS a model-catalog entry, just from a different picker. Absent or
+     *  empty means the agent has no reasoning axis to configure. */
+    reasoningOptions?: readonly AgentModelOption[] | undefined;
+    /** See `AgentSupportsCustomModel`. `undefined` allows custom input,
+     *  matching every adapter's default before this field existed. */
+    supportsCustomModel?: AgentSupportsCustomModel | undefined;
+    authStatus?: AgentAuthStatus | undefined;
+    /** Operator-actionable detail behind a `'missing'`/`'unknown'` status —
+     *  rendered as the meta line's tooltip so the card stays compact without
+     *  discarding the reason. */
+    authMessage?: string | undefined;
+    /** Short marketing-ish tags ("Official", "Lower cost"). The mechanism is
+     *  generic; the vocabulary is the host's — this package ships none. */
+    badges?: readonly string[] | undefined;
+    /** Why this agent is unavailable or only partially usable, as one or more
+     *  renderable "reason + fix button(s)" rows — see `AgentDiagnostic`. Absent
+     *  or empty means detection has nothing actionable to report (the common
+     *  case for a healthy, authenticated CLI). */
+    diagnostics?: readonly AgentDiagnostic[] | undefined;
+    /** Destination for an `{kind: 'openInstall'}` fix action — the CLI's
+     *  install/download page. Absent hides that action even if a diagnostic
+     *  requests it, per `AgentDiagnosticRow`'s "only render what the host can
+     *  actually do" contract. */
+    installUrl?: string | undefined;
+    /** Destination for an `{kind: 'openDocs'}` fix action — the CLI's
+     *  configuration/auth docs. Same absent-hides-the-action rule as
+     *  `installUrl`. */
+    docsUrl?: string | undefined;
+}
+/**
+ * Why a CLI agent is unavailable or only partially usable, in a shape a UI
+ * can render as "one-line reason + fix button(s)" instead of a silent grey
+ * card.
+ *
+ * Origin: OD's `packages/contracts/src/api/registry.ts#AgentDiagnostic` /
+ * `AgentFixIntent`, vendored into `@jini-ai/protocol`'s `agent-catalog.ts`
+ * (2026-07-29) unmodified. Mirrored here field-for-field rather than
+ * imported — this file has zero imports of its own (framework-free, part of
+ * this package's `./core` subpath), the same reasoning `DetectedAgent`'s own
+ * doc comment gives for mirroring `@jini-ai/agent-runtime`'s shape instead of
+ * depending on that Node-only package. A host on `@jini-ai/agent-runtime` /
+ * `@jini-ai/protocol` passes its `AgentDiagnostic[]` straight through
+ * unmapped, since the fields are identical.
+ */
+export interface AgentDiagnostic {
+    reason: AgentDiagnosticReason;
+    severity: AgentDiagnosticSeverity;
+    /** Short, human-readable, single-sentence explanation. */
+    message: string;
+    /** Optional longer context (e.g. the probe's stderr tail). */
+    detail?: string | undefined;
+    /** Directories PATH detection searched, surfaced verbatim for the
+     *  `'not-on-path'` case so the operator can see where detection looked
+     *  before being asked to set an explicit binary path. */
+    searchedDirs?: readonly string[] | undefined;
+    /** Ordered fix affordances the UI should offer for this diagnostic. */
+    fixActions?: readonly AgentFixIntent[] | undefined;
+}
+export type AgentDiagnosticReason = 
+/** The binary (and any fallback names) was not found on PATH. */
+'not-on-path'
+/** A file matched but is not executable (missing +x / wrong PATHEXT). */
+ | 'not-executable'
+/** A wrapper/shim was found but its target is gone (exit 126/127). */
+ | 'shim-broken'
+/** A user-set binary-path override points at a missing/invalid file. */
+ | 'configured-bin-invalid'
+/** Installed and invocable, but the CLI is not authenticated. */
+ | 'auth-missing'
+/** Installed, but auth status could not be verified. */
+ | 'auth-unknown';
+export type AgentDiagnosticSeverity = 'error' | 'warning' | 'info';
+/**
+ * A typed "what should the UI do to fix this" intent attached to an
+ * `AgentDiagnostic`. The UI renders one button per intent and owns the
+ * concrete handler (open a URL, re-run detection, write an env override);
+ * keeping the intent typed — rather than a pre-baked button label + URL —
+ * lets more than one surface render the same fix affordances from one
+ * source of truth.
+ */
+export type AgentFixIntent = 
+/** Open the agent's configuration/auth docs. */
+{
+    kind: 'openDocs';
+}
+/** Open the agent's install/download page. */
+ | {
+    kind: 'openInstall';
+}
+/** Re-run agent detection (this tab's rescan affordance). */
+ | {
+    kind: 'rescan';
+}
+/** Prompt the operator to point the host at an explicit binary by writing
+ *  `envKey` into `LocalCliConfig.envByAgentId` — used when the CLI is
+ *  installed somewhere PATH detection can't reach. */
+ | {
+    kind: 'setEnv';
+    envKey: string;
+}
+/** Clear a previously-set binary override so detection falls back to PATH. */
+ | {
+    kind: 'clearEnv';
+    envKey: string;
+}
+/** Launch the agent's interactive sign-in in a system terminal (used by
+ *  adapters whose OAuth flow cannot complete headlessly). */
+ | {
+    kind: 'launchOAuth';
+    agentId: string;
+};
+/**
+ * Catalog entry describing one operator-configurable CLI environment
+ * variable for one agent (a proxy base URL, a custom config directory, a
+ * binary-path override, …). Origin: `AGENT_CLI_ENV_FIELDS`. A host supplies
+ * its own catalog the same way it supplies `ProviderPreset`s — this package
+ * ships `DEFAULT_AGENT_CLI_ENV_FIELDS` as a starting point for the CLIs it
+ * already knows about (see `DEFAULT_AGENT_DESCRIPTIONS`), not as a fixed list.
+ */
+export interface AgentCliEnvFieldSpec {
+    agentId: string;
+    envKey: string;
+    /** Field label. This package's convention: the English string IS the i18n
+     *  key (see `PROTOCOL_OPTIONS`) — a host translates it, it does not supply
+     *  a separate key. */
+    label: string;
+    placeholder?: string | undefined;
+    /** Renders the input as `type="password"` and omits the value from any
+     *  plain-text display. */
+    secret?: boolean | undefined;
+    /** Marks this field as the agent's executable-path override — the field a
+     *  "use detected path" / "clear custom path" repair affordance (see
+     *  `agentExecutableRepairState`) should set or clear. At most one field per
+     *  `agentId` should carry this; the mechanism is generic, but this
+     *  package's own `DEFAULT_AGENT_CLI_ENV_FIELDS` only tags Codex's
+     *  `CODEX_BIN`, mirroring the origin's actual (Codex-only) behavior. */
+    kind?: 'binPath' | undefined;
+}
+/**
+ * Which detected CLI runs the operator's prompts, and with which model.
+ *
+ * `modelByAgentId` is keyed rather than flat because the picker is per-agent:
+ * switching from Claude to Codex and back must not silently hand Codex's model
+ * id to Claude. The origin kept the same shape (`cfg.agentModels`, keyed by
+ * agent id) for the same reason.
+ */
+export interface LocalCliConfig {
+    /** `null` until the operator picks one — deliberately not defaulted to the
+     *  first detected agent, so "nothing selected" stays distinguishable from
+     *  "the first one was chosen for you". */
+    agentId: string | null;
+    modelByAgentId?: Readonly<Record<string, string>>;
+    /** Per-agent reasoning-effort pick, keyed the same way as `modelByAgentId`
+     *  and for the same reason: switching agents and back must not hand one
+     *  agent's reasoning choice to another. */
+    reasoningByAgentId?: Readonly<Record<string, string>>;
+    /** Per-agent CLI environment overrides — proxy URLs, custom config dirs, a
+     *  binary-path override — keyed by agent id then env var name. Origin:
+     *  `AppConfig.agentCliEnv`. Mirrors that two-level shape directly rather
+     *  than flattening it, since a field's env-var name is only unique WITHIN
+     *  an agent (`CODEX_BIN` means nothing for `claude`). */
+    envByAgentId?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+}
+/** Which required BYOK field is still blank/invalid. Drives the inline
+ *  "required" markers without the tab hard-coding field labels. */
+export type ByokRequiredField = 'apiKey' | 'baseUrl' | 'model';
+export type ConnectionTestState = {
+    status: 'idle';
+} | {
+    status: 'testing';
+} | {
+    status: 'ok';
+    message?: string | undefined;
+} | {
+    status: 'error';
+    message: string;
+};
+/**
+ * Which executable a Local-CLI test actually invoked. `'primary'` is the
+ * normal case (the resolved/on-PATH binary ran). The two `fallback-*`
+ * variants report that a configured binary-path override
+ * (`AgentCliEnvFieldSpec` with `kind: 'binPath'`) could not be used and
+ * detection fell back to a different binary anyway — `'fallback-invalid'`
+ * when the override path never resolved to an executable, `'fallback-failed'`
+ * when it resolved but failed to run. Both are the trigger for
+ * `agentExecutableRepairState`'s repair affordance. Origin: OD's
+ * `ConnectionTestResponse.usedExecutableSource` (`'fallback_invalid'` /
+ * `'fallback_failed'`, renamed to this package's kebab-case convention).
+ */
+export type AgentExecutableSource = 'primary' | 'fallback-invalid' | 'fallback-failed';
+/** Result of the per-agent Test button, surfaced under the selected card.
+ *  Same idiom as `ConnectionTestState` — the two report the same kind of
+ *  outcome for the two execution modes, so they deliberately share a shape.
+ *  `usedExecutableSource`/`detectedExecutablePath` are optional passthrough
+ *  from `ExecutionPort.testAgent`'s result, present only when the host's
+ *  probe can report which binary it actually ran — see
+ *  `agentExecutableRepairState`. */
+export type AgentTestState = {
+    status: 'idle';
+} | {
+    status: 'testing';
+    agentId: string;
+} | {
+    status: 'ok';
+    agentId: string;
+    message?: string | undefined;
+    usedExecutableSource?: AgentExecutableSource | undefined;
+    detectedExecutablePath?: string | undefined;
+} | {
+    status: 'error';
+    agentId: string;
+    message: string;
+};
+/** The repair affordance a successful-but-fallback agent test unlocks: an
+ *  operator-set binary-path override didn't work, detection silently fell
+ *  back to a different binary, and the test still passed — so the operator
+ *  should be offered "use the binary that actually worked" or "clear the
+ *  override and stop overriding". `canUseDetected` is carried explicitly
+ *  (rather than always being implied `true`) so a future detection outcome
+ *  that finds a fallback path but cannot vouch for it has somewhere to say
+ *  so without a breaking shape change. */
+export interface AgentExecutableRepair {
+    detectedPath: string;
+    canUseDetected: boolean;
+}
+/** Result of a local-CLI rescan, surfaced as an inline status line. */
+export type AgentScanState = {
+    status: 'idle';
+} | {
+    status: 'scanning';
+} | {
+    status: 'ok';
+    count: number;
+} | {
+    status: 'error';
+    message: string;
+};
+/** Result of `ExecutionPort.listModels`, surfaced as an inline hint near the
+ *  Model field. Mirrors `ConnectionTestState`/`AgentScanState`'s shape
+ *  deliberately — one idiom for "async edge result" across this tab, per
+ *  this package's error-reporting contract (§3.2: reuse an existing union
+ *  over introducing a parallel shape). A failure here must NOT collapse
+ *  into the same "no models" the field already tolerates when a host
+ *  supplies no `listModels` at all — `'error'` is a distinct, renderable
+ *  state, not an empty `'ok'`. */
+export type ModelDiscoveryState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'ok';
+    models: readonly string[];
+} | {
+    status: 'error';
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/features/execution/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/execution/types.ts"],"names":[],"mappings":"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"}

package/dist/features/execution/types.js

@@ -0,0 +1,19 @@
+/**
+ * Origin: the inline `execution` tab body in `SettingsDialog.tsx`
+ * (lines 4080-5336), classified MIXED by
+ * `ADS-memory/reports/jini-port/recon/r6-god-component-internals.md` §1.3 — a generic
+ * "Local CLI vs. bring-your-own-key" execution switch wrapped in
+ * origin-specific managed-runtime/wallet chrome.
+ *
+ * What is ported: the mode switch, the provider/gateway chip groups, and the
+ * BYOK credential form (the origin had already factored these fields into
+ * `components/byok/*`, which is why this slice is assembly rather than
+ * surgery).
+ *
+ * What is deliberately left behind: the origin's managed-runtime wallet
+ * (balance polling, top-up, sign-in coachmarks, the `SettingsHighlight`
+ * one-shot focus hint) and its analytics tracking calls — all product-bound,
+ * none of it generic.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/execution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/execution/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/features/external-mcp/constants.d.ts

@@ -0,0 +1,3 @@
+import type { SourceFieldSpec } from '../source-config-list/types.js';
+export declare const MCP_SOURCE_FIELD_SPECS: readonly SourceFieldSpec[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/external-mcp/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/external-mcp/constants.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,eAAO,MAAM,sBAAsB,EAAE,SAAS,eAAe,EAoB5D,CAAC"}

package/dist/features/external-mcp/constants.js

@@ -0,0 +1,22 @@
+export const MCP_SOURCE_FIELD_SPECS = [
+    { key: 'id', label: 'ID', kind: 'text', required: true },
+    {
+        key: 'transport',
+        label: 'Transport',
+        kind: 'select',
+        required: true,
+        options: [
+            { value: 'stdio', label: 'stdio' },
+            { value: 'http', label: 'http' },
+        ],
+    },
+    { key: 'command', label: 'Command', kind: 'text', placeholder: 'e.g. npx, node, /path/to/binary' },
+    { key: 'args', label: 'Args', kind: 'text', placeholder: 'space-separated' },
+    // `secret-textarea`, not `textarea`: this block routinely holds live tokens —
+    // its own placeholder says so — and a plain textarea rendered them verbatim in
+    // the expandable server card, because `maskFieldValue` masked only `password`.
+    // The secret kind masks each line's VALUE while keeping its NAME visible, so
+    // an operator can still see which variables are set.
+    { key: 'env', label: 'Env (KEY=VALUE)', kind: 'secret-textarea', placeholder: 'GITHUB_TOKEN=ghp_…' },
+];
+//# sourceMappingURL=constants.js.map

package/dist/features/external-mcp/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/external-mcp/constants.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,sBAAsB,GAA+B;IAChE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;YAClC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;SACjC;KACF;IACD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iCAAiC,EAAE;IAClG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE;IAC5E,8EAA8E;IAC9E,+EAA+E;IAC/E,+EAA+E;IAC/E,6EAA6E;IAC7E,qDAAqD;IACrD,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,oBAAoB,EAAE;CACrG,CAAC"}

package/dist/features/external-mcp/index.d.ts

@@ -0,0 +1,4 @@
+export { MCP_SOURCE_FIELD_SPECS } from './constants.js';
+export { ExternalMcpTab } from './react/components/ExternalMcpTab.js';
+export type { ExternalMcpTabProps } from './react/components/ExternalMcpTab.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/external-mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/external-mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/features/external-mcp/index.js

@@ -0,0 +1,3 @@
+export { MCP_SOURCE_FIELD_SPECS } from './constants.js';
+export { ExternalMcpTab } from './react/components/ExternalMcpTab.js';
+//# sourceMappingURL=index.js.map

package/dist/features/external-mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/external-mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/features/external-mcp/react/components/ExternalMcpTab.d.ts

@@ -0,0 +1,23 @@
+import type { SourceConfigDependencies } from '../../../source-config-list/ports.js';
+import type { SourceConfigItem, SourceFieldSpec } from '../../../source-config-list/types.js';
+export interface ExternalMcpTabProps {
+    /** Host-supplied transport adapter — required, same as the generic primitive (no zero-config default is possible for an arbitrary `addSource`). */
+    dependencies: SourceConfigDependencies<SourceConfigItem>;
+    /** Defaults to the MCP-server shape (id/transport/command/args/env). Override only for a genuinely different source shape. */
+    fieldSpecs?: readonly SourceFieldSpec[];
+    /** Static/real connection-error banner text (e.g. "can't reach the local daemon"). `null`/omitted renders no banner. Takes a back seat to a real `fetchSources` failure, which always wins when both are present. */
+    connectionError?: string | null;
+    /** Footer save-status pill text (e.g. "All changes saved"). Omit to render no footer at all. */
+    saveStatusLabel?: string;
+    /** Footer "Stored at <path>" text. Shown only when `saveStatusLabel` is also given, matching the footer being one unit in the OD reference. */
+    configPath?: string;
+}
+/**
+ * OD as an MCP *client* — distinct from the "MCP server" tab, where the host
+ * is the one being connected to. Renders the add-form collapsed by default
+ * (OD's own default state); "Add server" reveals it. Presentational
+ * composition only: every list/add mutation is the two source-config-list
+ * hooks' own, already-tested logic.
+ */
+export declare function ExternalMcpTab({ dependencies, fieldSpecs, connectionError, saveStatusLabel, configPath, }: ExternalMcpTabProps): import("react").JSX.Element;
+//# sourceMappingURL=ExternalMcpTab.d.ts.map

package/dist/features/external-mcp/react/components/ExternalMcpTab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalMcpTab.d.ts","sourceRoot":"","sources":["../../../../../src/features/external-mcp/react/components/ExternalMcpTab.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAS9F,MAAM,WAAW,mBAAmB;IAClC,mJAAmJ;IACnJ,YAAY,EAAE,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;IACzD,8HAA8H;IAC9H,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACxC,qNAAqN;IACrN,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gGAAgG;IAChG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+IAA+I;IAC/I,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,YAAY,EACZ,UAAmC,EACnC,eAAsB,EACtB,eAAe,EACf,UAAU,GACX,EAAE,mBAAmB,+BA0GrB"}

package/dist/features/external-mcp/react/components/ExternalMcpTab.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// Assembled "External MCP servers" tab: OD as an MCP *client*. Built on top
+// of `features/source-config-list`'s generic `SourceConfigList` primitive
+// rather than mounting `SourceConfigListView` directly, because that view
+// renders its add-form unconditionally inline — OD's own chrome hides the
+// form behind an "Add server" button until clicked (see
+// `od-settings-external-mcp.png` vs `od-settings-external-mcp-customform.png`
+// in the parity handoff screenshots), which the generic view has no prop for.
+// This file wires the same two feature hooks
+// (`useWiredSourceConfigList`/`useWiredSourceConfigAddForm`) itself and adds
+// the header/toggle/footer chrome around them instead.
+//
+// Known, disclosed gap versus the OD reference: the origin add-server form
+// also has a "Display name (optional)" field and a "Need help? Map your MCP
+// JSON config" collapsible. Neither is part of the generic primitive's
+// contract — `AddSourceInput` has no `label`, and the collapsible is
+// MCP-transport-specific presentation, not a generic field kind (see
+// `source-config-list`'s own source-map notes). A host wanting either
+// composes it locally; this file doesn't fabricate them.
+import { useState } from 'react';
+import { DRAFT_TEST_SCOPE } from '../../../source-config-list/constants.js';
+import { Icon } from '../../../../react/components/Icon.js';
+import { useT } from '../../../i18n/index.js';
+import { SourceConfigAddForm } from '../../../source-config-list/react/components/SourceConfigAddForm.js';
+import { SourceConfigItemCard } from '../../../source-config-list/react/components/SourceConfigItemCard.js';
+import { useWiredSourceConfigAddForm } from '../../../source-config-list/react/hooks/useSourceConfigAddForm.js';
+import { useWiredSourceConfigList } from '../../../source-config-list/react/hooks/useSourceConfigList.js';
+import { MCP_SOURCE_FIELD_SPECS } from '../../constants.js';
+/**
+ * OD as an MCP *client* — distinct from the "MCP server" tab, where the host
+ * is the one being connected to. Renders the add-form collapsed by default
+ * (OD's own default state); "Add server" reveals it. Presentational
+ * composition only: every list/add mutation is the two source-config-list
+ * hooks' own, already-tested logic.
+ */
+export function ExternalMcpTab({ dependencies, fieldSpecs = MCP_SOURCE_FIELD_SPECS, connectionError = null, saveStatusLabel, configPath, }) {
+    const t = useT();
+    const [formOpen, setFormOpen] = useState(false);
+    const list = useWiredSourceConfigList({ dependencies });
+    const addForm = useWiredSourceConfigAddForm({
+        dependencies,
+        fieldSpecs,
+        onAdded: (source) => {
+            list.addSourceToList(source);
+            setFormOpen(false);
+        },
+    });
+    // A real load failure always wins over the host's static/decorative banner
+    // text — showing both would just be two banners saying overlapping things.
+    const banner = list.error ?? connectionError;
+    return (_jsxs("section", { className: "external-mcp-tab", children: [_jsxs("div", { className: "external-mcp-head", children: [_jsxs("div", { children: [_jsx("h3", { children: t('External MCP servers') }), _jsx("p", { className: "external-mcp-subtitle", children: t('Third-party tools for your coding agent.') })] }), _jsxs("button", { type: "button", className: "external-mcp-add-button", onClick: () => setFormOpen((open) => !open), "aria-expanded": formOpen, children: [_jsx(Icon, { name: "plus", size: 14 }), _jsx("span", { children: t('Add server') })] })] }), banner ? (_jsx("div", { className: "external-mcp-banner", role: "alert", children: t(banner) })) : null, formOpen ? (_jsx(SourceConfigAddForm, { fieldSpecs: fieldSpecs, values: addForm.values, validation: addForm.validation, submitAttempted: addForm.submitAttempted, submitting: addForm.submitting, ...(addForm.submitError ? { submitError: addForm.submitError } : {}), onFieldChange: addForm.setField, onTrustChange: addForm.setTrust, onSubmit: () => void addForm.submit(), canTest: list.capabilities.canTest, testing: list.isPending(DRAFT_TEST_SCOPE, 'test'), ...(list.testResults[DRAFT_TEST_SCOPE] ? { testResult: list.testResults[DRAFT_TEST_SCOPE] } : {}), onTest: () => void list.test(undefined, addForm.values), addLabel: "Add server" })) : null, list.loading ? (_jsx("div", { className: "source-config-list-loading", role: "status", children: t('Loading…') })) : list.sources.length === 0 ? (_jsxs("div", { className: "external-mcp-empty", children: [_jsx("p", { className: "external-mcp-empty-title", children: t('No MCP servers configured.') }), _jsx("p", { className: "external-mcp-empty-hint", children: t('Click "Add server" to get started — pick a template or set up a custom stdio / HTTP server.') })] })) : (_jsx("div", { className: "source-config-list-items", children: list.sources.map((source) => (_jsx(SourceConfigItemCard, { source: source, fieldSpecs: fieldSpecs, capabilities: list.capabilities, removing: list.isPending(source.id, 'remove'), refreshing: list.isPending(source.id, 'refresh'), settingTrust: list.isPending(source.id, 'trust'), testing: list.isPending(source.id, 'test'), updating: list.isPending(source.id, 'update'), onRefresh: () => void list.refresh(source.id), onRemove: () => void list.remove(source.id), onTrustChange: (trust) => void list.setTrust(source.id, trust), onTest: () => void list.test(source.id), onUpdate: (patch) => void list.update(source.id, patch), ...(list.testResults[source.id] ? { testResult: list.testResults[source.id] } : {}) }, source.id))) })), saveStatusLabel ? (_jsxs("div", { className: "external-mcp-footer", children: [_jsx("span", { className: "external-mcp-save-pill", children: t(saveStatusLabel) }), configPath ? (_jsxs("span", { className: "external-mcp-stored-at", children: [t('Stored at'), " ", _jsx("code", { children: configPath })] })) : null] })) : null] }));
+}
+//# sourceMappingURL=ExternalMcpTab.js.map

package/dist/features/external-mcp/react/components/ExternalMcpTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalMcpTab.js","sourceRoot":"","sources":["../../../../../src/features/external-mcp/react/components/ExternalMcpTab.tsx"],"names":[],"mappings":"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"}

package/dist/features/html-editor/canvas-content-wrapper.d.ts

@@ -0,0 +1,16 @@
+import type { CanvasContentWrapperNode } from './canvas-style.js';
+/**
+ * Wraps every current child node of `body` (elements, text, comments — whatever GrapesJS actually
+ * rendered there) in the given ancestor chain, outermost element first, then re-attaches the chain's
+ * outermost element to `body`.
+ *
+ * @param body - The canvas iframe's `<body>` element (`editor.Canvas.getBody()`), already populated
+ *   by GrapesJS's initial component render.
+ * @param chain - The ancestor chain to wrap with, outermost first — see
+ *   {@link CanvasContentWrapperNode}. `undefined` or `[]` is a no-op: the pre-existing "no wrapper"
+ *   behavior every caller had before this module existed.
+ * @complexity O(d + c) — d = chain depth (elements created), c = body's current child-node count
+ *   (each moved once, no copying).
+ */
+export declare function applyCanvasContentWrapper(body: HTMLElement, chain: readonly CanvasContentWrapperNode[] | undefined): void;
+//# sourceMappingURL=canvas-content-wrapper.d.ts.map

package/dist/features/html-editor/canvas-content-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-content-wrapper.d.ts","sourceRoot":"","sources":["../../../src/features/html-editor/canvas-content-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AA+ClE;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,GAAG,IAAI,CA4BzH"}