@pstdio/sdk 0.7.0 → 0.9.0

package/dist/extensions/types/context.d.ts

@@ -1,4 +1,4 @@
-import type { CommandHelpersApi, CommandInvocation, CommandMiddlewareResult, CommandNotice, CommandSource } from "./commands";
+import type { CommandHelpersApi, CommandInvocation, CommandMiddlewareResult, CommandNotice, CommandSource, WorkbenchAttachmentInvocationContext } from "./commands";
 import type { EventDeliveryResult, EventRef } from "./events";
 import type { JsonObject, MaybePromise, Struct } from "./json";
 import type { RepoContext, ResourceAnchor, ResourceRef } from "./resources";
@@ -67,7 +67,7 @@ export interface ExtensionSessionsApi {
         prompt?: string;
         template?: string;
         vars?: JsonObject;
-        harness?: unknown;
+        harness?: ExtensionHarnessInput;
         workspaceId?: string;
         repoId?: string;
         anchors?: ResourceAnchor[];
@@ -82,11 +82,208 @@ export interface ExtensionSessionsApi {
         vars?: JsonObject;
     }): Promise<void>;
 }
+export interface ExtensionHarnessInput {
+    harnessId: string;
+    model?: string;
+}
+/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
+export interface ExtensionTicket {
+    id: string;
+    shorthand: string;
+    created_at?: string;
+    updated_at?: string;
+    display_title?: string | null;
+    displayTitle?: string | null;
+    user_prompt?: string | null;
+    userPrompt?: string | null;
+    parent_id?: string | null;
+    parentId?: string | null;
+    draft?: boolean;
+    archived?: boolean;
+    status_id?: string | null;
+    status?: string | null;
+    status_name?: string | null;
+    tag_ids?: string[];
+    tag_names?: string[];
+    tagIds?: string[];
+    tagNames?: string[];
+    file_id?: string | null;
+    fileId?: string | null;
+    fileIds?: string[];
+}
+/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
+export interface ExtensionTicketFile {
+    id: string;
+    file_name?: string | null;
+    fileName?: string | null;
+    file_kind?: string | null;
+    fileKind?: string | null;
+    mime_type?: string | null;
+    mimeType?: string | null;
+    created_at?: string;
+    updated_at?: string;
+}
+/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
+export interface ExtensionTicketListInput {
+    status?: string;
+    tag?: string | string[];
+    archived?: boolean;
+    draft?: boolean;
+    parentId?: string;
+    shorthand?: string;
+    search?: string;
+}
+export interface ExtensionWorkspace {
+    id: string;
+    project_id?: string;
+    workspace_shorthand?: string;
+    /** @deprecated Legacy ticket-workspace linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket_id?: string | null;
+    /** @deprecated Legacy ticket-workspace linkage. Ticket data is owned by the pstdio tickets extension. */
+    ticket_shorthand?: string | null;
+    branch?: string | null;
+    worktree_path?: string | null;
+    attempt_status_id?: string | null;
+    attempt_status_name?: string | null;
+    initializing?: boolean;
+}
+/** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
+export interface ExtensionTicketsApi {
+    list(input?: ExtensionTicketListInput): Promise<ExtensionTicket[]>;
+    get(ref: string): Promise<ExtensionTicket>;
+    update(input: {
+        ticket: string;
+        content?: string;
+    }): Promise<ExtensionTicket>;
+    listFiles(ref: string): Promise<ExtensionTicketFile[]>;
+    createAttempt(input: {
+        ticket: string;
+        agent?: string;
+        branch?: string;
+        repoId?: string;
+        repoPath?: string;
+        mode?: "worktree" | "current_branch";
+        model?: string;
+        prompt?: string;
+        base?: string;
+        startSession?: boolean;
+    }): Promise<unknown>;
+    setStatus(input: {
+        ticket: string;
+        status: string;
+    }): Promise<void>;
+    updateWhenAllAttemptsMatch(input: {
+        ticket: string;
+        allAttemptsStatus: string;
+        setStatus: string;
+    }): Promise<{
+        updated: boolean;
+    }>;
+}
+/** @deprecated Legacy core ticket status extension API. Ticket statuses are owned by the pstdio tickets extension. */
+export interface ExtensionTicketStatus {
+    id: string;
+    name: string;
+    color: string;
+    sortOrder: number;
+    isDefault: boolean;
+    canCreate: boolean;
+    canDragIn: boolean;
+    canDragOut: boolean;
+    columnActions: string[];
+}
+/** @deprecated Legacy core ticket status extension API. Ticket statuses are owned by the pstdio tickets extension. */
+export interface ExtensionTicketStatusesApi {
+    list(): Promise<ExtensionTicketStatus[]>;
+    create(input: {
+        name: string;
+        color: string;
+        sortOrder?: number;
+        isDefault?: boolean;
+        canCreate?: boolean;
+        canDragIn?: boolean;
+        canDragOut?: boolean;
+        columnActions?: string[];
+    }): Promise<ExtensionTicketStatus>;
+    update(input: {
+        statusId: string;
+        name?: string;
+        color?: string;
+        sortOrder?: number;
+        canCreate?: boolean;
+        canDragIn?: boolean;
+        canDragOut?: boolean;
+        columnActions?: string[];
+    }): Promise<ExtensionTicketStatus>;
+    setDefault(input: {
+        statusId: string;
+    }): Promise<void>;
+    delete(input: {
+        statusId: string;
+    }): Promise<void>;
+}
+/** @deprecated Legacy ticket attempt status extension API. Workspace status automation is extension-owned. */
+export interface ExtensionAttemptStatus {
+    id: string;
+    name: string;
+    color: string;
+    sortOrder: number;
+    isDefault: boolean;
+}
+/** @deprecated Legacy ticket attempt status extension API. Workspace status automation is extension-owned. */
+export interface ExtensionAttemptStatusesApi {
+    list(): Promise<ExtensionAttemptStatus[]>;
+    create(input: {
+        name: string;
+        color: string;
+        sortOrder?: number;
+        isDefault?: boolean;
+    }): Promise<ExtensionAttemptStatus>;
+    update(input: {
+        statusId: string;
+        name?: string;
+        color?: string;
+        sortOrder?: number;
+        isDefault?: boolean;
+    }): Promise<ExtensionAttemptStatus>;
+    delete(input: {
+        statusId: string;
+    }): Promise<void>;
+}
+export interface SetAttemptStatusInput {
+    workspaceId: string;
+    status: string;
+    sessionId?: string;
+}
+export interface SetAttemptStatusResult {
+    id: string;
+    attempt_status_id: string | null;
+    from_status: string | null;
+    to_status: string;
+    status_change_id: string;
+}
 export interface ExtensionWorkspacesApi {
-    get(id: string): Promise<unknown>;
-    create(input: JsonObject): Promise<unknown>;
+    get(id: string): Promise<ExtensionWorkspace | null>;
+    getByShorthand(shorthand: string): Promise<ExtensionWorkspace | null>;
+    create(input: JsonObject): Promise<ExtensionWorkspace>;
     archive(id: string): Promise<void>;
     delete(id: string): Promise<void>;
+    setAttemptStatus(input: SetAttemptStatusInput): Promise<SetAttemptStatusResult>;
+}
+export interface BootstrapWorktreeInput {
+    repoPath: string;
+    worktreePath: string;
+    /** @deprecated Legacy ticket worktree bootstrap. Ticket worktree setup is owned by the pstdio tickets extension. */
+    ticketId?: string;
+}
+/** @deprecated Legacy ticket worktree cleanup. Ticket worktree setup is owned by the pstdio tickets extension. */
+export interface RemoveWorktreesForTicketInput {
+    ticketId?: string;
+}
+export interface ExtensionWorktreesApi {
+    bootstrap(input: BootstrapWorktreeInput): Promise<void>;
+    /** @deprecated Legacy ticket worktree cleanup. Ticket worktree setup is owned by the pstdio tickets extension. */
+    removeAllForTicket(input: RemoveWorktreesForTicketInput): Promise<number>;
 }
 export interface ExtensionReposApi {
     list(): Promise<RepoContext[]>;
@@ -117,13 +314,15 @@ export interface ProcessRunResult {
     stdout: string;
     stderr: string;
 }
+export interface ProcessRunInput {
+    command: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    timeoutMs?: number;
+}
 export interface ExtensionProcessApi {
-    run(input: {
-        command: string[];
-        cwd?: string;
-        env?: Record<string, string>;
-        timeoutMs?: number;
-    }): Promise<ProcessRunResult>;
+    run(input: ProcessRunInput): Promise<ProcessRunResult>;
+    runOrThrow(input: ProcessRunInput): Promise<ProcessRunResult>;
     spawnDetached(input: {
         command: string[];
         cwd?: string;
@@ -142,13 +341,13 @@ export interface ExtensionLoggerApi {
     warn(message: string, metadata?: JsonObject): void;
     error(message: string, metadata?: JsonObject): void;
 }
-export interface ExtensionSettingsApi<TSettings extends Struct = Struct> {
+export interface ExtensionSettingsApi<TSettings extends Record<string, unknown> = Record<string, unknown>> {
     all(): Promise<Partial<TSettings>>;
-    get<TKey extends keyof TSettings>(key: TKey): Promise<TSettings[TKey] | undefined>;
-    set<TKey extends keyof TSettings>(key: TKey, value: TSettings[TKey]): Promise<void>;
-    delete<TKey extends keyof TSettings>(key: TKey): Promise<void>;
+    get<TKey extends keyof TSettings & string>(key: TKey): Promise<TSettings[TKey] | undefined>;
+    set<TKey extends keyof TSettings & string>(key: TKey, value: TSettings[TKey]): Promise<void>;
+    delete<TKey extends keyof TSettings & string>(key: TKey): Promise<void>;
 }
-export interface ExtensionContextBase {
+export interface ExtensionContextBase<TSettings extends Record<string, unknown> = Record<string, unknown>> {
     projectId: string;
     extensionId: string;
     /** Extension package name. Used for grouping/prefixing user-facing references. */
@@ -158,8 +357,15 @@ export interface ExtensionContextBase {
     storage: ExtensionStorageApi;
     artifacts: ExtensionArtifactApi;
     files: ExtensionFilesApi;
+    /** @deprecated Legacy core ticket extension API. Ticket data is owned by the pstdio tickets extension. */
+    tickets: ExtensionTicketsApi;
+    /** @deprecated Legacy core ticket status extension API. Ticket statuses are owned by the pstdio tickets extension. */
+    ticketStatuses: ExtensionTicketStatusesApi;
+    /** @deprecated Legacy ticket attempt status extension API. Workspace status automation is extension-owned. */
+    attemptStatuses: ExtensionAttemptStatusesApi;
     sessions: ExtensionSessionsApi;
     workspaces: ExtensionWorkspacesApi;
+    worktrees: ExtensionWorktreesApi;
     repos: ExtensionReposApi;
     commands: CommandHelpersApi;
     events: ExtensionEventsApi;
@@ -168,19 +374,20 @@ export interface ExtensionContextBase {
     process: ExtensionProcessApi;
     net: ExtensionNetApi;
     logger: ExtensionLoggerApi;
-    settings: ExtensionSettingsApi;
+    settings: ExtensionSettingsApi<TSettings>;
 }
-export interface CommandContext<TParams extends Struct = Struct> extends ExtensionContextBase {
+export interface CommandContext<TParams extends Struct = Struct, TSettings extends Record<string, unknown> = Record<string, unknown>> extends ExtensionContextBase<TSettings> {
     commandId: string;
     invocationId: string;
     invocation: CommandInvocation<TParams>;
     resource?: ResourceRef;
+    attachment?: WorkbenchAttachmentInvocationContext;
     slot?: SlotInvocationContext;
     params: TParams;
 }
 export type CommandMiddlewareContext<TParams extends Struct = Struct> = CommandContext<TParams>;
 export type CommandMiddlewareHandler<TParams extends Struct = Struct> = (ctx: CommandMiddlewareContext<TParams>) => MaybePromise<CommandMiddlewareResult<TParams>>;
-export type CommandRunHandler<TParams extends Struct = Struct, TResult = unknown> = (ctx: CommandContext<TParams>) => MaybePromise<TResult>;
+export type CommandRunHandler<TParams extends Struct = Struct, TResult = unknown, TSettings extends Record<string, unknown> = Record<string, unknown>> = (ctx: CommandContext<TParams, TSettings>) => MaybePromise<TResult>;
 export interface EventContext extends ExtensionContextBase {
     eventId: string;
     deliveryId: string;

package/dist/extensions/types/contributions.d.ts

@@ -1,5 +1,7 @@
+import type { WorkbenchMenuTarget, WorkbenchModeLayoutTarget, WorkbenchSettingsScope, WorkbenchSettingsTarget, WorkbenchTreeTarget, WorkbenchViewTarget } from "../workbench-targets";
 import type { CommandRef, CommandSource } from "./commands";
-import type { JsonObject, Struct } from "./json";
+import type { JsonObject, JsonValue, Struct } from "./json";
+import type { ParamObjectSchema } from "./params";
 import type { PackageAssetDescriptor } from "./resources";
 import type { SlotRef } from "./slots";
 import type { WebviewCapabilityDeclaration } from "./webview-capabilities";
@@ -11,12 +13,14 @@ export interface CliContribution {
     hidden?: boolean;
 }
 export interface WhenExpression {
+    mode?: string | string[];
     source?: CommandSource[];
     resourceType?: string[];
     metadata?: JsonObject;
 }
 export interface MenuContribution<TSlotContext extends Struct = Struct, TParams extends Struct = Struct> {
-    slot: SlotRef<TSlotContext, "menu"> | string;
+    target?: WorkbenchMenuTarget;
+    slot?: SlotRef<TSlotContext, "menu"> | string;
     label?: string;
     group?: string;
     placement?: "first" | "default" | "last";
@@ -26,17 +30,51 @@ export interface MenuContribution<TSlotContext extends Struct = Struct, TParams
     params?: Partial<TParams>;
     presentation?: "menu-item" | "button" | "icon-button";
 }
-export interface NavigationContribution<TSlotContext extends Struct = Struct, TParams extends Struct = Struct> {
-    slot: SlotRef<TSlotContext, "navigation"> | string;
+export interface TreeItemContribution<TParams extends Struct = Struct> {
+    target: WorkbenchTreeTarget;
     label: string;
     group?: string;
     placement?: "first" | "default" | "last";
-    route?: string;
-    href?: string;
-    command?: CommandRef<TParams, unknown> | string;
-    params?: Partial<TParams>;
     icon?: string;
     when?: WhenExpression;
+    action: {
+        kind: "command";
+        command: CommandRef<TParams, unknown> | string;
+        params?: Partial<TParams>;
+    } | {
+        kind: "dataRenderer";
+        dataRenderer: string;
+    } | {
+        kind: "route";
+        route: string;
+    } | {
+        kind: "href";
+        href: string;
+    };
+}
+export type WorkbenchLayoutTarget = WorkbenchModeLayoutTarget;
+export type ModeTargetContribution = {
+    target: WorkbenchLayoutTarget;
+    view: string;
+    title?: string;
+    resource?: string;
+    pinned?: boolean;
+} | {
+    target: WorkbenchLayoutTarget;
+    resource: string;
+    widget?: string;
+    title?: string;
+    pinned?: boolean;
+};
+export interface ModeLayoutContribution {
+    reset?: boolean | WorkbenchLayoutTarget[];
+    open?: ModeTargetContribution[];
+}
+export interface ModeContribution {
+    id?: string;
+    label: string;
+    icon?: string;
+    layout?: ModeLayoutContribution;
 }
 export interface WebviewContribution {
     entry: PackageAssetDescriptor;
@@ -45,7 +83,8 @@ export interface WebviewContribution {
 }
 export interface ViewContribution<TSlotContext extends Struct = Struct> {
     title: string;
-    slot: SlotRef<TSlotContext, "view"> | string;
+    target?: WorkbenchViewTarget;
+    slot?: SlotRef<TSlotContext, "view"> | string;
     group?: string;
     placement?: "first" | "default" | "last";
     webview: WebviewContribution;
@@ -57,9 +96,143 @@ export interface RouteContribution {
 }
 export interface SettingsPanelContribution<TSlotContext extends Struct = Struct> {
     title: string;
-    slot: SlotRef<TSlotContext, "settings"> | string;
+    target?: WorkbenchSettingsTarget;
+    scope?: WorkbenchSettingsScope;
+    slot?: SlotRef<TSlotContext, "settings"> | string;
     webview: WebviewContribution;
 }
+export type DataRendererViewMode = "board" | "list";
+export type DataRendererSortDirection = "asc" | "desc";
+export interface DataRendererEnumOption {
+    value: string;
+    label: string;
+    color?: string;
+    icon?: string | null;
+}
+export type DataRendererAttributeType = {
+    kind: "enum";
+    options: DataRendererEnumOption[];
+} | {
+    kind: "enum-multi";
+    options: DataRendererEnumOption[];
+} | {
+    kind: "string";
+} | {
+    kind: "date";
+} | {
+    kind: "number";
+} | {
+    kind: "user";
+};
+export interface DataRendererAttributeDescriptor {
+    id: string;
+    label: string;
+    type: DataRendererAttributeType;
+    filterable?: boolean;
+    groupable?: boolean;
+    sortable?: boolean;
+    displayable?: boolean;
+    editable?: boolean;
+}
+export interface DataRendererSettings {
+    viewMode: DataRendererViewMode;
+    columnGrouping: string;
+    rowGrouping: string;
+    ordering: {
+        attributeId: string;
+        direction: DataRendererSortDirection;
+    };
+    displayProperties: string[];
+}
+export type DataRendererFilterState = Record<string, string[]>;
+export interface DataRendererQueryParams {
+    settings: DataRendererSettings;
+    filters: DataRendererFilterState;
+}
+export interface DataRendererResourceRef {
+    type: string;
+    id: string;
+    projectId?: string;
+    label?: string;
+    extensionId?: string;
+    metadata?: JsonObject;
+}
+export interface DataRendererRow {
+    id: string;
+    title: string;
+    resource?: DataRendererResourceRef;
+    attributes: Record<string, unknown>;
+}
+export interface DataRendererColumnAction {
+    id: string;
+    label: string;
+    icon?: string;
+}
+export interface DataRendererBoardColumnConfig {
+    color?: string;
+    canDragIn?: boolean;
+    canDragOut?: boolean;
+    canCreate?: boolean;
+    actions?: DataRendererColumnAction[];
+}
+export interface DataRendererQueryResult {
+    rows: DataRendererRow[];
+    attributes?: DataRendererAttributeDescriptor[];
+    boardColumnConfigs?: Record<string, DataRendererBoardColumnConfig>;
+}
+export interface DataRendererCreateRowContribution<TParams extends ParamObjectSchema = ParamObjectSchema> {
+    command: CommandRef<Struct, unknown> | string;
+    title?: string;
+    submitLabel?: string;
+    columnParam?: string;
+    params?: TParams;
+}
+export interface DataRendererSavedViewsContribution {
+    resourceKind: string;
+    scope?: "project" | "user";
+}
+export interface DataRendererContribution {
+    title: string;
+    resourceKind?: string;
+    attributes?: DataRendererAttributeDescriptor[];
+    queryCommand: CommandRef<DataRendererQueryParams, DataRendererQueryResult> | string;
+    updateAttributeCommand?: CommandRef<{
+        rowId: string;
+        attributeId: string;
+        value: unknown;
+    }, unknown> | string;
+    reorderCommand?: CommandRef<{
+        rowId: string;
+        beforeRowId?: string;
+    }, unknown> | string;
+    columnActionCommand?: CommandRef<{
+        columnId: string;
+        actionId: string;
+    }, unknown> | string;
+    createRow?: DataRendererCreateRowContribution;
+    defaultSettings?: Partial<DataRendererSettings>;
+    defaultFilters?: DataRendererFilterState;
+    emptyTitle?: string;
+    emptyDescription?: string;
+    hideToolbar?: boolean;
+    savedViews?: DataRendererSavedViewsContribution;
+}
+export type ExtensionSettingScope = "global" | "project";
+export type ExtensionSettingValueType = "boolean" | "number" | "string" | "array" | "object";
+export type ExtensionSettingValueForType<TType extends ExtensionSettingValueType> = TType extends "boolean" ? boolean : TType extends "number" ? number : TType extends "string" ? string : TType extends "array" ? JsonValue[] : JsonObject;
+export type ExtensionSettingProperty<TType extends ExtensionSettingValueType = ExtensionSettingValueType> = {
+    [TSettingType in TType]: {
+        type: TSettingType;
+        scope: ExtensionSettingScope;
+        default?: ExtensionSettingValueForType<TSettingType>;
+        enum?: ExtensionSettingValueForType<TSettingType>[];
+        title?: string;
+        description?: string;
+    };
+}[TType];
+export interface ExtensionSettingsContribution<TProperties extends Record<string, ExtensionSettingProperty> = Record<string, ExtensionSettingProperty>> {
+    properties: TProperties;
+}
 export interface RendererContribution<TSlotContext extends Struct = Struct> {
     slot: SlotRef<TSlotContext, "renderer"> | string;
     for: string;

package/dist/extensions/types/extension.d.ts

@@ -1,10 +1,9 @@
 import type { CommandRef } from "./commands";
 import type { CommandMiddlewareHandler, CommandRunHandler, EventContext, ExtensionContextBase, MigrationContext, SetupContext } from "./context";
-import type { ArtifactMountContribution, CliContribution, FileIconThemeContribution, MenuContribution, NavigationContribution, RendererContribution, RouteContribution, SettingsPanelContribution, SkillContribution, TemplateContribution, TemplateTypeContribution, ThemeContribution, ViewContribution } from "./contributions";
+import type { ArtifactMountContribution, CliContribution, DataRendererContribution, ExtensionSettingsContribution, FileIconThemeContribution, MenuContribution, ModeContribution, RendererContribution, RouteContribution, SettingsPanelContribution, SkillContribution, TemplateContribution, TemplateTypeContribution, ThemeContribution, TreeItemContribution, ViewContribution } from "./contributions";
 import type { EventRef } from "./events";
 import type { JsonObject, MaybePromise, Struct } from "./json";
 import type { ParamObjectSchema, ParamsOf } from "./params";
-import type { SlotRef } from "./slots";
 /** Current host extension API version. `engines.pstdio` in package.json is a semver range checked against this. */
 export declare const EXTENSION_API_VERSION = "1.0.0";
 type SchemaParams<TSchema extends ParamObjectSchema | undefined> = TSchema extends ParamObjectSchema ? ParamsOf<TSchema> : Struct;
@@ -12,13 +11,13 @@ type SchemaParams<TSchema extends ParamObjectSchema | undefined> = TSchema exten
  * A command exposed by an extension. The `params` schema (typed via `params.*`) drives
  * the inferred shape of `ctx.params` in `run`.
  */
-export interface CommandDefinition<TSchema extends ParamObjectSchema | undefined = ParamObjectSchema | undefined, TResult = unknown> {
+export interface CommandDefinition<TSchema extends ParamObjectSchema | undefined = ParamObjectSchema | undefined, TResult = unknown, TSettings extends Record<string, unknown> = Record<string, unknown>> {
     title: string;
     description?: string;
     params?: TSchema;
     menus?: MenuContribution[];
     cli?: boolean | CliContribution;
-    run: CommandRunHandler<SchemaParams<TSchema>, TResult>;
+    run: CommandRunHandler<SchemaParams<TSchema>, TResult, TSettings>;
 }
 /**
  * Middleware that runs before a command. Use `command` for a typed `CommandRef`; use
@@ -101,6 +100,7 @@ export interface ProjectExtensionInstance {
     enabled: boolean;
     config: JsonObject;
 }
+export type ExtensionLoadScope = "user" | "repo";
 /** Validated view of an extension's package.json identity fields. */
 export interface PackageManifest {
     /** Extension package name. Matches `^[a-z][a-z0-9-]*$`. */
@@ -117,22 +117,28 @@ export interface PackageManifest {
     main: string;
     /** Semver range checked against the host extension API version. */
     enginesPstdio: string;
+    /** Prompt Studio-specific package metadata. */
+    pstdio?: {
+        /** Install/load scope. Defaults to "user" when omitted. */
+        scope?: ExtensionLoadScope;
+    };
     /** Derived `${publisher}.${name}`. */
     id: string;
 }
-/** UI surface contributions: slots, routes, panels, renderers. */
+/** UI surface contributions: modes, routes, panels, renderers. */
 export interface UiContributions {
-    slots?: Record<string, SlotRef>;
+    modes?: Record<string, ModeContribution>;
     routes?: Record<string, RouteContribution>;
     views?: Record<string, ViewContribution>;
-    navigation?: Record<string, NavigationContribution>;
+    treeItems?: Record<string, TreeItemContribution>;
     settingsPanels?: Record<string, SettingsPanelContribution>;
+    dataRenderers?: Record<string, DataRendererContribution>;
     activityRenderers?: Record<string, RendererContribution>;
     sessionAnchorRenderers?: Record<string, RendererContribution>;
 }
 /** Behavioural surface: commands, middleware, hooks, schedules. */
 export interface BehaviourContributions {
-    commands?: Record<string, CommandDefinition<any, any>>;
+    commands?: Record<string, CommandDefinition<any, any, any>>;
     middlewares?: Record<string, MiddlewareDefinition<any, any>>;
     hooks?: Record<string, HookDefinition<any>>;
     schedules?: Record<string, ScheduleContribution<any>>;
@@ -162,7 +168,7 @@ export interface ExtensionLifecycle {
  * contribution surfaces.
  */
 export interface ExtensionDefinition extends UiContributions, BehaviourContributions, AssetContributions, ProviderContributions, ExtensionLifecycle {
-    settings?: ParamObjectSchema;
+    settings?: ExtensionSettingsContribution;
 }
-export type ExtensionSourceKind = "local" | "package" | "builtin";
+export type ExtensionSourceKind = "local_path" | "git" | "registry";
 export {};