@crewx/sdk 0.9.0-rc.11 → 0.9.0-rc.111

package/dist/types/task-log.types.d.ts

@@ -1,3 +1,4 @@
+import type { DelegationResult } from '../task-log/delegation-trailer.js';
 export type TaskLogEntryType = 'text' | 'thinking' | 'tool_use' | 'tool_result' | 'error' | 'info' | 'running_instruction' | 'agent_call';
 export interface TaskLogEntry {
     timestamp: string;
@@ -8,6 +9,7 @@ export interface TaskLogEntry {
     toolUseId?: string;
     resultPreview?: string;
     isError?: boolean;
+    delegationResult?: DelegationResult | null;
     targetAgent?: string;
     targetTaskId?: string;
     errorMessage?: string;

package/dist/ui-card/index.d.ts

@@ -0,0 +1,2 @@
+export { extractLegacyWorkflowRunId, scanLegacyUiCardAt, scanLegacyUiCardTags, } from './legacy-card-parser';
+export type { LegacyUiCardTag } from './legacy-card-parser';

package/dist/ui-card/legacy-card-parser.d.ts

@@ -0,0 +1,11 @@
+export interface LegacyUiCardTag {
+    start: number;
+    end: number;
+    raw: string;
+    closed: boolean;
+    attrs: Readonly<Record<string, string>>;
+    privileged: boolean;
+}
+export declare function scanLegacyUiCardAt(text: string, start: number): LegacyUiCardTag;
+export declare function scanLegacyUiCardTags(text: string): LegacyUiCardTag[];
+export declare function extractLegacyWorkflowRunId(text: string | null | undefined): string | undefined;

package/dist/ui-instance/definition.d.ts

@@ -0,0 +1,6 @@
+import type { UiDefinition, UiDefinitionInput, UiDefinitionRef } from './types.js';
+export declare function hashUiDefinition(input: UiDefinitionInput): string;
+export declare function definitionKey(ref: UiDefinitionRef): string;
+export declare function validateDefinition(definition: UiDefinition): void;
+export declare function isExactCapability(value: string): boolean;
+export declare function refFromDefinition(definition: UiDefinition): UiDefinitionRef;

package/dist/ui-instance/errors.d.ts

@@ -0,0 +1,17 @@
+export type UiRuntimeErrorCode = 'UNAUTHENTICATED' | 'INSTANCE_NOT_FOUND' | 'WORKSPACE_MISMATCH' | 'INSTANCE_NOT_ACTIONABLE' | 'DEFINITION_UNSUPPORTED' | 'CAPABILITY_DENIED' | 'INPUT_INVALID' | 'REVISION_CONFLICT' | 'ACTION_UNAVAILABLE' | 'HANDLER_NOT_FOUND' | 'ACTION_IN_FLIGHT' | 'DOMAIN_REJECTED' | 'EXECUTION_FAILED';
+export declare class UiRuntimeError extends Error {
+    readonly code: UiRuntimeErrorCode;
+    readonly currentRevision?: number | undefined;
+    readonly name = "UiRuntimeError";
+    constructor(code: UiRuntimeErrorCode, message?: string, currentRevision?: number | undefined);
+}
+export declare class UiRetryableDatabaseError extends Error {
+    readonly cause: unknown;
+    readonly name = "UiRetryableDatabaseError";
+    constructor(cause: unknown);
+}
+export declare class UiReservationConflictError extends Error {
+    readonly currentRevision: number;
+    readonly name = "UiReservationConflictError";
+    constructor(currentRevision: number);
+}

package/dist/ui-instance/index.d.ts

@@ -0,0 +1,9 @@
+export type { ActionReceipt, ActionReceiptOutcome, CreateUiInstanceInput, JsonObject, JsonPrimitive, JsonValue, UiActionHandlerContext, UiActionHandlerRegistration, UiActionHandlerResult, UiActionEnvelope, UiActionConfirmation, UiActor, UiDefinition, UiDefinitionAction, UiDefinitionDisplayMode, UiDefinitionInput, UiDefinitionRef, UiDefinitionUsage, UiProjectionPolicy, UiExecutionContext, UiAuthenticatedActor, UiAuthenticatedExecutionContext, UiAuthenticatedGrantPolicy, UiServerRuntimeFacade, UiServerRuntimeOptions, UiAgentContextProjection, UiExternalActionHandlerRegistration, UiInstance, UiInstanceStatus, UiLocalGrantPolicy, UiRuntimeFacade, UiRuntimeOptions, UiStateActionHandlerRegistration, } from './types.js';
+export { resolveUiEffectiveCapabilities } from './types.js';
+export { UiRuntimeError } from './errors.js';
+export type { UiRuntimeErrorCode } from './errors.js';
+export { projectSafeJsonObject } from './json.js';
+export { hashUiDefinition } from './definition.js';
+export { UiInstanceStore, openUiInstanceReadStore } from './store.js';
+export type { UiAuditSnapshotInput, UiInstanceReadStore } from './store.js';
+export { createUiRuntimeForTest, createUiServerRuntime } from './runtime.js';

package/dist/ui-instance/json.d.ts

@@ -0,0 +1,5 @@
+import type { JsonObject, JsonValue } from './types.js';
+export declare function projectSafeJsonObject(value: unknown, envelopeDepth?: number): JsonObject;
+export declare function serializeJson(value: JsonValue): string;
+export declare function canonicalJson(value: JsonValue): string;
+export declare function utf8ByteLength(value: string): number;

package/dist/ui-instance/runtime.d.ts

@@ -0,0 +1,18 @@
+import type { UiRuntimeFacade, UiRuntimeOptions, UiServerRuntimeFacade, UiServerRuntimeOptions } from './types.js';
+import { UiInstanceStore } from './store.js';
+export interface UiRuntimeTestHooks {
+    beforeReservation?: () => Promise<void> | void;
+    injectDatabaseError?: () => unknown | undefined;
+    bumpRevisionBeforeCas?: boolean;
+}
+export interface UiRuntimeForTestOptions extends UiRuntimeOptions {
+    workspaceId: string;
+    testHooks?: UiRuntimeTestHooks;
+    store?: UiInstanceStore;
+}
+export interface UiRuntimeStoreOptions {
+    readonly store?: UiInstanceStore;
+}
+export declare function createUiRuntime(workspaceId: string, options: UiRuntimeOptions & UiRuntimeStoreOptions): UiRuntimeFacade;
+export declare function createUiRuntimeForTest(options: UiRuntimeForTestOptions): UiRuntimeFacade;
+export declare function createUiServerRuntime(options: UiServerRuntimeOptions & UiRuntimeStoreOptions): UiServerRuntimeFacade;

package/dist/ui-instance/store.d.ts

@@ -0,0 +1,99 @@
+import type { ActionReceipt, ActionReceiptOutcome, JsonObject, UiActionHandlerContext, UiActor, UiInstance } from './types.js';
+interface UiInstanceStoreTestHooks {
+    injectDatabaseError?: () => unknown | undefined;
+    bumpRevisionBeforeCas?: boolean;
+    beforeOpenRead?: () => void;
+}
+export interface ReservationInput {
+    instanceId: string;
+    requestId: string;
+    actionId: string;
+    actor: UiActor;
+    source: 'cli' | 'ui_host' | 'system' | 'mcp';
+    expectedRevision: number;
+    input: JsonObject;
+    now: number;
+}
+export interface StateHandlerExecution {
+    handle: (context: UiActionHandlerContext) => {
+        state?: JsonObject;
+        result?: JsonObject;
+    } | {
+        outcome: 'rejected' | 'failed';
+        errorCode: string;
+        state?: JsonObject;
+        result?: JsonObject;
+    };
+}
+export interface ExternalReservation {
+    instance: UiInstance;
+    receipt: ActionReceipt;
+    reservedRevision: number;
+    reservationMarker: number;
+}
+export interface UiAuditSnapshotInput {
+    instanceId: string;
+    workspaceId: string;
+    updatedAt: number;
+    state: JsonObject;
+}
+export interface UiInstanceReadStore {
+    get(instanceId: string): UiInstance | null;
+    listByThread(workspaceId: string, threadId: string): UiInstance[];
+    close(): void;
+}
+export declare function openUiInstanceReadStore(dbPath?: string): UiInstanceReadStore;
+export declare class UiInstanceStore {
+    private readonly handle;
+    private readonly db;
+    private readonly testHooks?;
+    constructor(dbPath?: string, testHooks?: UiInstanceStoreTestHooks);
+    close(): void;
+    create(input: {
+        id: string;
+        definitionId: string;
+        definitionVersion: number;
+        definitionHash: string;
+        workspaceId: string;
+        threadId: string;
+        appId?: string | null;
+        anchorTaskId: string | null;
+        domainRef: JsonObject;
+        state: JsonObject;
+        grants: readonly string[];
+        now: number;
+    }): UiInstance;
+    get(instanceId: string): UiInstance | null;
+    open(input: {
+        id?: string;
+        appId: string;
+        definitionId: string;
+        definitionVersion: number;
+        definitionHash: string;
+        workspaceId: string;
+        threadId: string;
+        anchorTaskId?: string | null;
+        domainRef: JsonObject;
+        state: JsonObject;
+        grants: readonly string[];
+        now: number;
+    }): UiInstance;
+    listByThread(workspaceId: string, threadId: string): UiInstance[];
+    updateAuditSnapshot(input: UiAuditSnapshotInput): UiInstance | null;
+    getReceipt(instanceId: string, requestId: string): ActionReceipt | null;
+    runStateOnly(reservation: ReservationInput, handler: StateHandlerExecution['handle']): ActionReceipt;
+    reserveExternal(reservation: ReservationInput): ExternalReservation;
+    settleExternal(input: {
+        reservation: ReservationInput;
+        reservedRevision: number;
+        reservationMarker: number;
+        outcome: ActionReceiptOutcome;
+        state: JsonObject;
+        result: JsonObject | null;
+        errorCode: string | null;
+        apply?: () => ReturnType<StateHandlerExecution['handle']>;
+        restoreRevisionOnFailure?: boolean;
+        now: number;
+    }): ActionReceipt;
+}
+export {};

package/dist/ui-instance/types.d.ts

@@ -0,0 +1,213 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type UiInstanceStatus = 'active' | 'completed' | 'expired' | 'revoked' | 'unsupported';
+export interface UiDefinitionRef {
+    id: string;
+    version: number;
+    hash: string;
+}
+export type UiDefinitionUsage = 'card' | 'window';
+export type UiDefinitionDisplayMode = 'inline' | 'floating' | 'focused';
+export declare const DEFAULT_UI_DEFINITION_USAGE: UiDefinitionUsage;
+export type UiActionConfirmation = 'none' | 'native';
+export interface UiDefinitionAction {
+    readonly capabilities: readonly string[];
+    readonly inputKeys?: readonly string[];
+    readonly confirmation?: UiActionConfirmation;
+    readonly resultProjection?: UiProjectionPolicy;
+}
+export interface UiProjectionPolicy {
+    allow: readonly string[];
+}
+export interface UiDefinitionInput {
+    readonly id: string;
+    readonly version: number;
+    readonly sourceHash?: string;
+    readonly usage?: UiDefinitionUsage;
+    readonly detailPanel?: boolean;
+    readonly displayModes?: readonly UiDefinitionDisplayMode[];
+    readonly actions: Readonly<Record<string, UiDefinitionAction>>;
+    readonly renderer?: string;
+    readonly surfaces?: readonly string[];
+    readonly stateProjection?: UiProjectionPolicy;
+}
+export interface UiDefinition extends UiDefinitionInput {
+    readonly hash: string;
+}
+export interface CreateUiInstanceInput {
+    definition: UiDefinitionRef;
+    workspaceId: string;
+    threadId: string;
+    anchorTaskId?: string;
+    domainRef: JsonObject;
+    state: JsonObject;
+}
+export interface UiInstance {
+    id: string;
+    definition: UiDefinitionRef;
+    workspaceId: string;
+    threadId: string;
+    appId: string | null;
+    anchorTaskId: string | null;
+    domainRef: JsonObject;
+    state: JsonObject;
+    revision: number;
+    status: UiInstanceStatus;
+    grantedCapabilities: readonly string[];
+    createdAt: number;
+    updatedAt: number;
+}
+export interface UiActionEnvelope {
+    instanceId: string;
+    actionId: string;
+    expectedRevision: number;
+    requestId: string;
+    input: JsonObject;
+}
+export type UiActor = {
+    kind: 'local';
+    id: string;
+} | {
+    kind: 'authenticated';
+    id: string;
+} | {
+    kind: 'agent';
+    id: string;
+};
+export interface UiExecutionContext {
+    source: 'cli' | 'ui_host' | 'system' | 'mcp';
+    workspaceId: string;
+    actor: UiActor;
+}
+export interface UiAuthenticatedActor {
+    kind: 'authenticated';
+    id: string;
+}
+export interface UiAuthenticatedExecutionContext {
+    source: 'ui_host' | 'system';
+    workspaceId: string;
+    threadId: string;
+    actor: UiAuthenticatedActor;
+}
+export type ActionReceiptOutcome = 'succeeded' | 'rejected' | 'failed' | 'conflicted' | 'expired';
+export interface ActionReceipt {
+    id: string;
+    instanceId: string;
+    requestId: string;
+    actionId: string;
+    actor: UiActor;
+    source: 'cli' | 'ui_host' | 'system' | 'mcp';
+    expectedRevision: number;
+    beforeRevision: number;
+    afterRevision: number | null;
+    status: 'requested' | 'settled';
+    outcome: ActionReceiptOutcome | null;
+    input: JsonObject;
+    result: JsonObject | null;
+    errorCode: string | null;
+    requestedAt: number;
+    settledAt: number | null;
+}
+export interface UiLocalGrantPolicy {
+    resolveInstanceGrants(input: {
+        definition: UiDefinitionRef;
+        workspaceId: string;
+        actor: Extract<UiActor, {
+            kind: 'local';
+        }>;
+    }): readonly string[];
+    resolveActionCapabilities(input: {
+        definition: UiDefinitionRef;
+        actionId: string;
+    }): readonly string[];
+}
+export interface UiActionHandlerContext {
+    instance: UiInstance;
+    actor: UiActor;
+    source: 'cli' | 'ui_host' | 'system' | 'mcp';
+    input: JsonObject;
+    requestId: string;
+}
+export type UiActionHandlerResult = {
+    state?: JsonObject;
+    result?: JsonObject;
+} | {
+    outcome: 'rejected' | 'failed';
+    errorCode: string;
+    state?: JsonObject;
+    result?: JsonObject;
+};
+export interface UiStateActionHandlerRegistration {
+    definitionId: string;
+    version: number;
+    actionId: string;
+    kind: 'state';
+    handle: (context: UiActionHandlerContext) => UiActionHandlerResult;
+}
+export interface UiExternalActionHandlerRegistration {
+    definitionId: string;
+    version: number;
+    actionId: string;
+    kind: 'external';
+    handle: (context: UiActionHandlerContext) => Promise<UiActionHandlerResult>;
+}
+export type UiActionHandlerRegistration = UiStateActionHandlerRegistration | UiExternalActionHandlerRegistration;
+export interface UiRuntimeOptions {
+    dbPath?: string;
+    localActor: Extract<UiActor, {
+        kind: 'local';
+    }>;
+    localGrantPolicy?: UiLocalGrantPolicy;
+    definitions?: readonly UiDefinition[];
+    handlers?: readonly UiActionHandlerRegistration[];
+    clock?: () => number;
+}
+export interface UiRuntimeFacade {
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    createInstance(input: CreateUiInstanceInput): Promise<UiInstance>;
+    dispatchAction(input: UiActionEnvelope, context: UiExecutionContext): Promise<ActionReceipt>;
+    getReceipt(instanceId: string, requestId: string): Promise<ActionReceipt | null>;
+    close(): void;
+}
+export interface UiAuthenticatedGrantPolicy {
+    resolveInstanceGrants(input: {
+        definition: UiDefinitionRef;
+        workspaceId: string;
+        actor: UiAuthenticatedActor;
+    }): readonly string[];
+    resolveDispatchCapabilities?(input: {
+        definition: UiDefinitionRef;
+        actionId: string;
+        actor: UiAuthenticatedActor;
+        source: 'ui_host' | 'system';
+    }): readonly string[];
+}
+export declare function resolveUiEffectiveCapabilities(declared: readonly string[], instanceGranted: readonly string[], dispatchGranted?: readonly string[]): readonly string[];
+export interface UiServerRuntimeOptions {
+    workspaceId: string;
+    dbPath: string;
+    definitions: readonly UiDefinition[];
+    handlers: readonly UiActionHandlerRegistration[];
+    grantPolicy: UiAuthenticatedGrantPolicy;
+    clock?: () => number;
+}
+export interface UiServerRuntimeFacade {
+    resolveDefinition(ref: UiDefinitionRef): UiDefinition | null;
+    getInstance(instanceId: string, context: UiAuthenticatedExecutionContext): Promise<UiInstance | null>;
+    createInstance(input: CreateUiInstanceInput, context: UiAuthenticatedExecutionContext): Promise<UiInstance>;
+    dispatchAction(input: UiActionEnvelope, context: UiAuthenticatedExecutionContext): Promise<ActionReceipt>;
+    getReceipt(instanceId: string, requestId: string, context: UiAuthenticatedExecutionContext): Promise<ActionReceipt | null>;
+    close(): void;
+}
+export interface UiAgentContextProjection {
+    instanceId: string;
+    definition: UiDefinitionRef;
+    revision: number;
+    facts: JsonObject;
+    recentChanges: readonly JsonObject[];
+    pendingDecision: JsonObject | null;
+    availableActions: readonly string[];
+}

package/dist/ui-plugin/index.d.ts

@@ -0,0 +1,4 @@
+export { canonicalManifestJson, manifestHash } from './manifest.js';
+export { UiPluginValidationError, normalizeManifest, validateInitialState, validateManifest, validatePayload, } from './validator.js';
+export { UI_PLUGIN_CAPABILITY_PATTERN, UI_PLUGIN_HANDLER_PATTERN, UI_PLUGIN_IDENTIFIER_PATTERN, UI_PLUGIN_MAX_ACTIONS, UI_PLUGIN_MAX_ARRAY_LENGTH, UI_PLUGIN_MAX_CANDIDATE_DEPTH, UI_PLUGIN_MAX_COMMAND_LENGTH, UI_PLUGIN_MAX_COMMAND_PARTS, UI_PLUGIN_MAX_DISCOVERED_APPS, UI_PLUGIN_MAX_DISCOVERY_TIME_MS, UI_PLUGIN_MAX_HEIGHT, UI_PLUGIN_MAX_INITIAL_STATE_BYTES, UI_PLUGIN_MAX_JSON_DEPTH, UI_PLUGIN_MAX_MANIFEST_BYTES, UI_PLUGIN_MAX_PROJECTION_PATHS, UI_PLUGIN_MAX_SCHEMA_DEPTH, UI_PLUGIN_MAX_SCHEMA_PROPERTIES, UI_PLUGIN_MAX_STRING_LENGTH, UI_PLUGIN_MAX_SUBTREE_BYTES, UI_PLUGIN_MAX_SURFACES, UI_PLUGIN_RESERVED_STATE_KEYS, UI_PLUGIN_SAFE_PATH_PATTERN, UI_PLUGIN_SAFE_PATH_SEGMENT_PATTERN, UI_PLUGIN_SKILL_TOKEN_PATTERN, UI_PLUGIN_SURFACES, UI_PLUGIN_TONES, isUiPluginReservedStateKey, } from './limits.js';
+export type { UiPluginActivation, UiPluginAction, UiPluginBackend, UiPluginCardShellNode, UiPluginCoreBackend, UiPluginFieldSchema, UiPluginHeadingNode, UiPluginInputSchema, UiPluginJsonSchema, UiPluginJsonSchemaType, UiPluginLabeledTextNode, UiPluginLayoutNode, UiPluginLayout, UiPluginManifest, UiPluginManifestMode, UiPluginManifestV1, UiPluginManifestV2, UiPluginMetaBannerNode, UiPluginNormalizedManifestV2, UiPluginNormalizedV2, UiPluginPayload, UiPluginPayloadValue, UiPluginPrimitive, UiPluginProjectionPolicy, UiPluginResourceMetadata, UiPluginResourceRef, UiPluginSchemaType, UiPluginSchema, UiPluginSize, UiPluginSkillBackend, UiPluginStep, UiPluginStepFlowNode, UiPluginStepListSchema, UiPluginTextListNode, UiPluginTextListSchema, UiPluginTextSchema, UiPluginSurface, UiPluginTone, UiPluginHandlerMetadata, UiPluginValidationErrorCode, UiPluginValidationOptions, } from './types.js';

package/dist/ui-plugin/limits.d.ts

@@ -0,0 +1,27 @@
+export declare const UI_PLUGIN_MAX_STRING_LENGTH = 4096;
+export declare const UI_PLUGIN_MAX_ARRAY_LENGTH = 128;
+export declare const UI_PLUGIN_MAX_SUBTREE_BYTES: number;
+export declare const UI_PLUGIN_MAX_INITIAL_STATE_BYTES: number;
+export declare const UI_PLUGIN_MAX_JSON_DEPTH = 8;
+export declare const UI_PLUGIN_MAX_SCHEMA_DEPTH = 8;
+export declare const UI_PLUGIN_MAX_SCHEMA_PROPERTIES = 64;
+export declare const UI_PLUGIN_MAX_ACTIONS = 32;
+export declare const UI_PLUGIN_MAX_SURFACES = 2;
+export declare const UI_PLUGIN_MAX_PROJECTION_PATHS = 128;
+export declare const UI_PLUGIN_MAX_COMMAND_PARTS = 16;
+export declare const UI_PLUGIN_MAX_COMMAND_LENGTH = 256;
+export declare const UI_PLUGIN_MAX_HEIGHT = 720;
+export declare const UI_PLUGIN_MAX_DISCOVERED_APPS = 64;
+export declare const UI_PLUGIN_MAX_MANIFEST_BYTES: number;
+export declare const UI_PLUGIN_MAX_CANDIDATE_DEPTH = 2;
+export declare const UI_PLUGIN_MAX_DISCOVERY_TIME_MS = 5000;
+export declare const UI_PLUGIN_RESERVED_STATE_KEYS: readonly ["__proto__", "prototype", "constructor", "proof", "token", "secret", "password", "cookie", "authorization", "private_key", "private-key", "stack", "exception", "plugin_text", "url", "uri", "endpoint", "path", "filename", "filepath", "cwd", "shell", "directory", "dir", "folder"];
+export declare function isUiPluginReservedStateKey(key: string): boolean;
+export declare const UI_PLUGIN_SAFE_PATH_SEGMENT_PATTERN: RegExp;
+export declare const UI_PLUGIN_SAFE_PATH_PATTERN: RegExp;
+export declare const UI_PLUGIN_IDENTIFIER_PATTERN: RegExp;
+export declare const UI_PLUGIN_CAPABILITY_PATTERN: RegExp;
+export declare const UI_PLUGIN_HANDLER_PATTERN: RegExp;
+export declare const UI_PLUGIN_SKILL_TOKEN_PATTERN: RegExp;
+export declare const UI_PLUGIN_TONES: readonly ["blue", "violet", "emerald", "amber", "rose", "sky", "slate", "indigo"];
+export declare const UI_PLUGIN_SURFACES: readonly ["inline", "panel"];

package/dist/ui-plugin/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { UiPluginManifest } from './types.js';
+export declare function canonicalManifestJson(manifest: UiPluginManifest): string;
+export declare function manifestHash(manifest: UiPluginManifest): string;

package/dist/ui-plugin/types.d.ts

@@ -0,0 +1,174 @@
+import type { JsonValue, UiDefinitionInput } from '../ui-instance/types.js';
+export type UiPluginPrimitive = 'card-shell' | 'meta-banner' | 'heading' | 'labeled-text' | 'step-flow' | 'text-list';
+export type UiPluginSchemaType = 'text' | 'text-list' | 'step-list';
+export interface UiPluginTextSchema {
+    readonly type: 'text';
+    readonly maxLength: number;
+}
+export interface UiPluginTextListSchema {
+    readonly type: 'text-list';
+    readonly max: number;
+    readonly itemMaxLength: number;
+}
+export interface UiPluginStepListSchema {
+    readonly type: 'step-list';
+    readonly min: number;
+    readonly max: number;
+    readonly labelMaxLength: number;
+    readonly detailMaxLength: number;
+}
+export type UiPluginFieldSchema = UiPluginTextSchema | UiPluginTextListSchema | UiPluginStepListSchema;
+export type UiPluginSchema = Readonly<Record<string, UiPluginFieldSchema>>;
+export interface UiPluginActivation {
+    readonly kind: 'fenced-code';
+    readonly language: string;
+}
+export interface UiPluginCardShellNode {
+    readonly primitive: 'card-shell';
+}
+export interface UiPluginMetaBannerNode {
+    readonly primitive: 'meta-banner';
+    readonly badgeToken: string;
+    readonly noticeToken: string;
+}
+export interface UiPluginHeadingNode {
+    readonly primitive: 'heading';
+    readonly field: string;
+}
+export interface UiPluginLabeledTextNode {
+    readonly primitive: 'labeled-text';
+    readonly titleToken: string;
+    readonly field: string;
+    readonly variant: 'callout';
+}
+export interface UiPluginStepFlowNode {
+    readonly primitive: 'step-flow';
+    readonly titleToken: string;
+    readonly field: string;
+}
+export interface UiPluginTextListNode {
+    readonly primitive: 'text-list';
+    readonly titleToken: string;
+    readonly field: string;
+    readonly emptyToken?: string;
+    readonly hideWhenEmpty?: boolean;
+}
+export type UiPluginLayoutNode = UiPluginCardShellNode | UiPluginMetaBannerNode | UiPluginHeadingNode | UiPluginLabeledTextNode | UiPluginStepFlowNode | UiPluginTextListNode;
+export type UiPluginLayout = readonly UiPluginLayoutNode[];
+export interface UiPluginManifestV1 {
+    readonly manifestVersion: 1;
+    readonly pluginId: string;
+    readonly definitionId: string;
+    readonly version: number;
+    readonly primitiveSet: number;
+    readonly activation: UiPluginActivation;
+    readonly schema: UiPluginSchema;
+    readonly layout: UiPluginLayout;
+}
+export type UiPluginManifestMode = 'local' | 'installed' | 'published';
+export type UiPluginSurface = 'inline' | 'panel';
+export type UiPluginTone = 'blue' | 'violet' | 'emerald' | 'amber' | 'rose' | 'sky' | 'slate' | 'indigo';
+export type UiPluginJsonSchemaType = 'object' | 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'null';
+export interface UiPluginJsonSchema {
+    readonly type: UiPluginJsonSchemaType;
+    readonly enum?: readonly JsonValue[];
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+    readonly minProperties?: number;
+    readonly maxProperties?: number;
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly items?: UiPluginJsonSchema;
+    readonly properties?: Readonly<Record<string, UiPluginJsonSchema>>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: false;
+}
+export interface UiPluginInputSchema extends UiPluginJsonSchema {
+    readonly type: 'object';
+    readonly properties: Readonly<Record<string, UiPluginJsonSchema>>;
+}
+export interface UiPluginProjectionPolicy {
+    readonly allow: readonly string[];
+}
+export interface UiPluginCoreBackend {
+    readonly type: 'core';
+    readonly handler: string;
+}
+export interface UiPluginSkillBackend {
+    readonly type: 'skill';
+    readonly command: readonly string[];
+}
+export type UiPluginBackend = UiPluginCoreBackend | UiPluginSkillBackend;
+export interface UiPluginAction {
+    readonly actionId: string;
+    readonly capability: string;
+    readonly mutation: boolean;
+    readonly inputSchema: UiPluginInputSchema;
+    readonly resultProjection: UiPluginProjectionPolicy;
+    readonly backend: UiPluginBackend;
+}
+export interface UiPluginResourceRef {
+    readonly path: 'ui/index.html' | 'ui/state.json';
+    readonly hash?: string;
+}
+export interface UiPluginSize {
+    readonly height: number;
+}
+export interface UiPluginManifestV2 {
+    readonly manifestVersion: 2;
+    readonly pluginId: string;
+    readonly definitionId: string;
+    readonly version: number;
+    readonly name: string;
+    readonly description: string;
+    readonly icon?: string;
+    readonly tone?: UiPluginTone;
+    readonly entry: 'ui/index.html';
+    readonly entryHash?: string;
+    readonly initialState?: {
+        readonly path: 'ui/state.json';
+        readonly hash?: string;
+    };
+    readonly usage?: UiDefinitionInput['usage'];
+    readonly detailPanel?: UiDefinitionInput['detailPanel'];
+    readonly displayModes?: UiDefinitionInput['displayModes'];
+    readonly surfaces: readonly UiPluginSurface[];
+    readonly size: UiPluginSize;
+    readonly stateProjection: UiPluginProjectionPolicy;
+    readonly actions: readonly UiPluginAction[];
+}
+export type UiPluginManifest = UiPluginManifestV1 | UiPluginManifestV2;
+export interface UiPluginHandlerMetadata {
+    readonly actionId: string;
+    readonly mutation: boolean;
+    readonly backend: UiPluginBackend;
+    readonly launchPolicy: 'allowed' | 'denied';
+    readonly denialCode?: 'EXEC_DENIED';
+}
+export interface UiPluginResourceMetadata {
+    readonly entry: UiPluginResourceRef;
+    readonly initialState?: {
+        readonly path: 'ui/state.json';
+        readonly hash?: string;
+    };
+}
+export interface UiPluginNormalizedManifestV2 {
+    readonly manifest: UiPluginManifestV2;
+    readonly definition: UiDefinitionInput;
+    readonly handlers: Readonly<Record<string, UiPluginHandlerMetadata>>;
+    readonly resources: UiPluginResourceMetadata;
+}
+export type UiPluginNormalizedV2 = UiPluginNormalizedManifestV2;
+export interface UiPluginStep {
+    readonly label: string;
+    readonly detail: string;
+}
+export type UiPluginPayloadValue = string | string[] | UiPluginStep[];
+export type UiPluginPayload = Record<string, UiPluginPayloadValue>;
+export interface UiPluginValidationOptions {
+    readonly supportedPrimitiveSet?: number;
+    readonly mode?: UiPluginManifestMode;
+}
+export type UiPluginValidationErrorCode = 'MANIFEST_INVALID' | 'PRIMITIVE_UNKNOWN' | 'PRIMITIVE_SET_UNSUPPORTED' | 'SCHEMA_TYPE_UNSUPPORTED' | 'TOKEN_INVALID' | 'UNSAFE_VALUE' | 'LIMIT_EXCEEDED' | 'INITIAL_STATE_INVALID';

package/dist/ui-plugin/validator.d.ts

@@ -0,0 +1,15 @@
+import type { UiPluginManifest, UiPluginManifestV1, UiPluginManifestV2, UiPluginNormalizedManifestV2, UiPluginPayload, UiPluginValidationErrorCode, UiPluginValidationOptions } from './types.js';
+import type { JsonObject } from '../ui-instance/types.js';
+export declare class UiPluginValidationError extends Error {
+    readonly code: UiPluginValidationErrorCode;
+    readonly name = "UiPluginValidationError";
+    constructor(code: UiPluginValidationErrorCode, message?: string);
+}
+export declare function validateInitialState(value: unknown): JsonObject;
+export declare function validateManifest(input: UiPluginManifestV1, options?: UiPluginValidationOptions): UiPluginManifestV1;
+export declare function validateManifest(input: UiPluginManifestV2, options?: UiPluginValidationOptions): UiPluginManifestV2;
+export declare function validateManifest(input: unknown, options?: UiPluginValidationOptions): UiPluginManifest;
+export declare function normalizeManifest(input: UiPluginManifestV1, options?: UiPluginValidationOptions): UiPluginManifestV1;
+export declare function normalizeManifest(input: UiPluginManifestV2, options?: UiPluginValidationOptions): UiPluginNormalizedManifestV2;
+export declare function normalizeManifest(input: unknown, options?: UiPluginValidationOptions): UiPluginManifestV1 | UiPluginNormalizedManifestV2;
+export declare function validatePayload(manifest: UiPluginManifestV1, rawPayload: unknown): UiPluginPayload;