@synopackageland/sdk 0.9.8 → 0.10.0

package/dist/src/background/BackgroundPanel.vue.d.ts

@@ -2,6 +2,9 @@ import type { Context } from '../context';
 type __VLS_Props = {
     ctx: Pick<Context, 'call' | 'locale'>;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare function refresh(): Promise<void>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    refresh: typeof refresh;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/src/background/i18n.d.ts

@@ -11,7 +11,6 @@ export declare const backgroundCatalogs: Record<import("..").UiLocale, {
     pickerTitle: string;
     pickerConsent: string;
     submit: string;
-    refresh: string;
     cancel: string;
     result: string;
     download: string;

package/dist/src/background/picker-provider.d.ts

@@ -1,3 +1,3 @@
 import type { Context } from '../context';
 import type { NasProvider } from '../nas/contract';
-export declare function createBackgroundPickerProvider(ctx: Pick<Context, 'call'>): NasProvider;
+export declare function createBackgroundPickerProvider(ctx: Pick<Context, 'call' | 'requestTimeout'>): NasProvider;

package/dist/src/bridge/i18n.d.ts

@@ -0,0 +1,5 @@
+export declare const bridgeCatalogs: Record<string, Record<string, string>>;
+/** The text of a code the bridge runtime adds (app_unavailable, and the
+ * services' limit_exceeded, read_failed, identity_unavailable) in a DSM or
+ * BCP-47 language; undefined for any other code. */
+export declare function bridgeErrorCopy(e: unknown, locale: string): string | undefined;

package/dist/src/context.d.ts

@@ -73,7 +73,7 @@ export interface PortalAccess {
     register?(): Promise<PortalStatus>;
     unregister?(): Promise<PortalStatus>;
     openControlPanel(): void;
-    mountPanel(element: HTMLElement): {
+    mountPanel?(element: HTMLElement): {
         refresh(): Promise<void>;
         dispose(): void;
     };
@@ -90,7 +90,13 @@ export interface AuthorizationAccess {
     request(): Promise<AuthorizationStatus>;
     revoke(): Promise<AuthorizationStatus>;
 }
+export declare const DEFAULT_REQUEST_TIMEOUT = 60000;
+export declare function clientTimeout(requestTimeout?: number): number;
+export interface CallOptions {
+    signal?: AbortSignal;
+}
 export interface Context {
+    requestTimeout?: number;
     authorization?: AuthorizationAccess;
     delegate?: import('./delegate/long-running').BackgroundSaveFacade;
     files?: {
@@ -98,17 +104,35 @@ export interface Context {
         token?: () => string | undefined;
     };
     displayName?: string;
+    appIcon?: string;
+    fullPage?: boolean;
     executor?: import('./delegate/executor-setup').ExecutorSetup;
     user?: {
         readonly name: string;
         readonly isAdmin: boolean;
     };
     portal?: PortalAccess;
-    call<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+    call<T = unknown>(method: string, params?: Record<string, unknown>, options?: CallOptions): Promise<T>;
     reopen(fn: () => void): () => void;
     locale: string;
+    lang?: string;
+    t?: (key: string, params?: Record<string, unknown>) => string;
+    appWindow?: unknown;
     host: HostAdapter;
 }
+/** What tells a full page apart: the launch, or the host when an older CLI omits it. */
+export type LaunchContext = {
+    fullPage: boolean;
+    host?: Pick<HostAdapter, 'platform'>;
+} | {
+    fullPage?: boolean;
+    host: Pick<HostAdapter, 'platform'>;
+};
+/** What AppShell reads: the launch, the brand, the signed-in account and, with app-root, the window to bring to the front. */
+export type ShellContext = LaunchContext & Pick<Context, 'displayName' | 'appIcon' | 'user'> & {
+    host?: Partial<Pick<HostAdapter, 'activateWindow'>>;
+};
+export declare function isFullPage(ctx: LaunchContext): boolean;
 export interface AppStatus {
     package: string;
     version: string;

package/dist/src/delegate/BackgroundSavePanel.vue.d.ts

@@ -7,9 +7,14 @@ type __VLS_Props = {
     picker?: {
         provider: NasProvider;
         keys: string[];
+        labels?: Record<string, string>;
     };
+    pickerErrorText?: (error: unknown) => string | undefined;
+    sampleSave?: boolean;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    refresh: () => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     authorized: (grant: DestinationGrant) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onAuthorized?: ((grant: DestinationGrant) => any) | undefined;

package/dist/src/delegate/DelegatePanel.vue.d.ts

@@ -2,6 +2,8 @@ import type { Context } from '../context';
 type __VLS_Props = {
     ctx: Pick<Context, 'call' | 'locale'>;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    refresh: () => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/src/delegate/ExecutorSettings.vue.d.ts

@@ -4,7 +4,10 @@ type __VLS_Props = {
     locale?: string;
     ctx?: Pick<Context, 'call'>;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare function refresh(): Promise<void>;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    refresh: typeof refresh;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     confirmed: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onConfirmed?: (() => any) | undefined;

package/dist/src/delegate/copy.d.ts

@@ -15,7 +15,6 @@ export declare const delegateCatalogs: Record<import("..").UiLocale, {
     blocked: string;
     loading: string;
     details: string;
-    refresh: string;
     revoke: string;
     cancel: string;
     noDelegations: string;
@@ -49,6 +48,15 @@ export declare const delegateCatalogs: Record<import("..").UiLocale, {
     scopeChangeHelp: string;
     confirmScope: string;
     waiting_executor: string;
+    status: string;
+    statusReady: string;
+    statusNeeds: string;
+    statusScope: string;
+    statusBlocked: string;
+    statusConfirming: string;
+    hintPassword: string;
+    hintUnchanged: string;
+    retry: string;
 }>;
 export declare function delegateCopy(locale?: string): {
     title: string;
@@ -65,7 +73,6 @@ export declare function delegateCopy(locale?: string): {
     blocked: string;
     loading: string;
     details: string;
-    refresh: string;
     revoke: string;
     cancel: string;
     noDelegations: string;
@@ -99,5 +106,14 @@ export declare function delegateCopy(locale?: string): {
     scopeChangeHelp: string;
     confirmScope: string;
     waiting_executor: string;
+    status: string;
+    statusReady: string;
+    statusNeeds: string;
+    statusScope: string;
+    statusBlocked: string;
+    statusConfirming: string;
+    hintPassword: string;
+    hintUnchanged: string;
+    retry: string;
 };
 export declare function errorCopy(error: unknown, copy: DelegateCopy): string;

package/dist/src/delegate/root.d.ts

@@ -0,0 +1,40 @@
+import type { RootJobsGetParams } from '../protocol/v1';
+export type RootRunResult = {
+    request_id: string;
+    exit_code: number;
+    stderr: string;
+} & ({
+    output: string;
+} | {
+    staging: string;
+    size: number;
+});
+export type RootJobState = 'running' | 'stopping' | 'succeeded' | 'failed' | 'canceled' | 'timed-out' | 'interrupted';
+export type RootJobRef = RootJobsGetParams;
+export interface RootJobProgress {
+    percent?: number;
+    message?: string;
+    phase?: string;
+}
+export interface RootJob {
+    job_id: string;
+    name: string;
+    state: RootJobState;
+    requested_by: string;
+    started_at: string;
+    ended_at?: string;
+    exit_code?: number;
+    cancel_reason?: string;
+    progress?: RootJobProgress;
+    result?: unknown;
+    output: string;
+}
+export type RootStartResult = {
+    job_id: string;
+    state: 'running';
+};
+export type RootJobSummary = Omit<RootJob, 'progress' | 'result' | 'output'> & {
+    progress?: {
+        percent?: number;
+    };
+};

package/dist/src/delegate/save-copy.d.ts

@@ -10,7 +10,6 @@ export declare const saveCatalogs: Record<import("..").UiLocale, {
     choose: string;
     needs: string;
     cancel: string;
-    refresh: string;
     disable: string;
     enable: string;
     disableHelp: string;
@@ -30,8 +29,10 @@ export declare const saveCatalogs: Record<import("..").UiLocale, {
     loading: string;
     denied: string;
     permission: string;
+    permissionSelect: string;
     missing: string;
     appPrivilege: string;
+    appPrivilegeSelect: string;
     session: string;
     conflict: string;
     space: string;
@@ -42,6 +43,15 @@ export declare const saveCatalogs: Record<import("..").UiLocale, {
     reselect: string;
     example: string;
     exampleHelp: string;
+    statusEnabled: string;
+    statusDisabled: string;
+    statusNeedsScope: string;
+    status: string;
+    file: string;
+    size: string;
+    location: string;
+    openFolder: string;
+    retry: string;
 }>;
 export declare function saveCopy(locale?: string): {
     title: string;
@@ -55,7 +65,6 @@ export declare function saveCopy(locale?: string): {
     choose: string;
     needs: string;
     cancel: string;
-    refresh: string;
     disable: string;
     enable: string;
     disableHelp: string;
@@ -75,8 +84,10 @@ export declare function saveCopy(locale?: string): {
     loading: string;
     denied: string;
     permission: string;
+    permissionSelect: string;
     missing: string;
     appPrivilege: string;
+    appPrivilegeSelect: string;
     session: string;
     conflict: string;
     space: string;
@@ -87,6 +98,15 @@ export declare function saveCopy(locale?: string): {
     reselect: string;
     example: string;
     exampleHelp: string;
+    statusEnabled: string;
+    statusDisabled: string;
+    statusNeedsScope: string;
+    status: string;
+    file: string;
+    size: string;
+    location: string;
+    openFolder: string;
+    retry: string;
 };
 export declare function saveError(error: unknown, copy?: {
     title: string;
@@ -100,7 +120,6 @@ export declare function saveError(error: unknown, copy?: {
     choose: string;
     needs: string;
     cancel: string;
-    refresh: string;
     disable: string;
     enable: string;
     disableHelp: string;
@@ -120,8 +139,10 @@ export declare function saveError(error: unknown, copy?: {
     loading: string;
     denied: string;
     permission: string;
+    permissionSelect: string;
     missing: string;
     appPrivilege: string;
+    appPrivilegeSelect: string;
     session: string;
     conflict: string;
     space: string;
@@ -132,4 +153,13 @@ export declare function saveError(error: unknown, copy?: {
     reselect: string;
     example: string;
     exampleHelp: string;
-}): string;
+    statusEnabled: string;
+    statusDisabled: string;
+    statusNeedsScope: string;
+    status: string;
+    file: string;
+    size: string;
+    location: string;
+    openFolder: string;
+    retry: string;
+}, situation?: 'save' | 'select'): string;

package/dist/src/i18n.d.ts

@@ -22,3 +22,5 @@ export type Message = string | {
 /** Fills {key} placeholders from values; a placeholder without a value stays
  * visible. Plural forms are chosen by values.count in the given locale. */
 export declare function format(message: Message, values: Record<string, string | number>, locale?: string): string;
+/** The colon between a label and its value: full-width in Chinese and Japanese. */
+export declare function labelSeparator(locale: string): string;

package/dist/src/identity/i18n.d.ts

@@ -20,6 +20,8 @@ export declare const identityCatalogs: Record<import("..").UiLocale, {
         https_required: string;
         auth_unavailable: string;
         session_required: string;
+        cross_origin: string;
+        origin_required: string;
         failed: string;
     };
     notices: {

package/dist/src/index.d.ts

@@ -1,6 +1,9 @@
 export type * from './context';
+export { DEFAULT_REQUEST_TIMEOUT, clientTimeout, isFullPage } from './context';
+export { createStandaloneHost, createStandaloneContext } from './standalone';
 export type * from './delegate/long-running';
 export type * from './delegate/executor-setup';
+export type * from './delegate/root';
 export type * from './nas/contract';
 export type { AppSaveJob } from './delegate/facade';
 export type { FileTransport } from './files/transfers';
@@ -11,8 +14,8 @@ export { FILE_STATION_APP, fileStationPath, openFolderInFileStation, openFileInF
 export { createBackgroundPickerProvider } from './background/picker-provider';
 export { scopedPicker } from './delegate/scoped-picker';
 export { requestKey } from './background/request-key';
-export { shellPages, activePage, type ShellPage, type ShellFeatureFlags } from './shell/pages';
-export { uiLocale, uiLocales, catalogs, mergeCatalogs, format, type Message, type UiLocale } from './i18n';
+export { shellPages, activePage, type ShellPage, type ShellFeatureFlags, type PageRef } from './shell/pages';
+export { uiLocale, uiLocales, catalogs, mergeCatalogs, format, labelSeparator, type Message, type UiLocale } from './i18n';
 export { nasCopy, nasErrorCopy, nasCatalogs, type NasCopy } from './nas/locale';
 export { shellCopy, shellCatalogs, type ShellCopy } from './shell/i18n';
 export { identityCopy, identityCatalogs, type IdentityCopy, type IdentityNotice } from './identity/i18n';
@@ -20,5 +23,8 @@ export { backgroundCopy, backgroundErrorCopy, backgroundCatalogs, type Backgroun
 export { delegateCopy, errorCopy, delegateCatalogs, type DelegateCopy } from './delegate/copy';
 export { saveCopy, saveError, saveCatalogs } from './delegate/save-copy';
 export { authorizationCopy, authorizationCatalogs } from './authorization/i18n';
+export { portalMessages, portalCatalogs } from './portal/i18n';
+export { bridgeErrorCopy, bridgeCatalogs } from './bridge/i18n';
+export { createPortalAccess, type PortalOptions } from './portal/access';
 export * from './protocol/v1';
 export { encodeRequest, decodeResponse, type ProtocolAuth, type ProtocolResponse } from './protocol/codec';

package/dist/src/nas/NasPicker.vue.d.ts

@@ -8,15 +8,18 @@ type __VLS_Props = {
     title?: string;
     description?: string;
     destination?: DestinationSelection;
+    errorText?: (error: unknown) => string | undefined;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     selected: (path: string) => any;
     "update:open": (value: boolean) => any;
     authorized: (grant: DestinationGrant) => any;
+    refused: (error: unknown) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelected?: ((path: string) => any) | undefined;
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
     onAuthorized?: ((grant: DestinationGrant) => any) | undefined;
+    onRefused?: ((error: unknown) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/src/nas/locale.d.ts

@@ -26,6 +26,7 @@ export declare const nasCatalogs: Record<import("..").UiLocale, {
     errorUnavailable: string;
     errorCanceled: string;
     errorTimeout: string;
+    errorOrigin: string;
     metadata: string;
     fileKind: string;
     directoryKind: string;

package/dist/src/nas/provider.d.ts

@@ -1,3 +1,3 @@
-import type { Context } from '../context';
+import { type Context } from '../context';
 import type { NasProvider } from './contract';
-export declare function createNasProvider(ctx: Pick<Context, 'call' | 'files'>): NasProvider;
+export declare function createNasProvider(ctx: Pick<Context, 'call' | 'files' | 'requestTimeout'>): NasProvider;

package/dist/src/portal/access.d.ts

@@ -0,0 +1,16 @@
+import type { PortalAccess } from '../context';
+export interface PortalOptions {
+    appId: string;
+    defaultAlias: string;
+    locale: string;
+    location: {
+        protocol: string;
+        host: string;
+    };
+    call(method: 'portal.status' | 'portal.register' | 'portal.unregister', params: Record<string, never>): Promise<unknown>;
+    send(api: string, method: string, version: number, params: Record<string, unknown>): Promise<unknown>;
+    isAdmin(): boolean;
+    launch(app: string, params: Record<string, string>): void;
+    entry?: boolean;
+}
+export declare function createPortalAccess(options: PortalOptions): PortalAccess;

package/dist/src/portal/i18n.d.ts

@@ -0,0 +1,3 @@
+export declare const portalCatalogs: Record<string, Record<string, string>>;
+/** PortalAccess.messages: the panel text in a DSM or BCP-47 language, keyed without the portal. prefix. */
+export declare function portalMessages(locale: string): Record<string, string>;

package/dist/src/protocol/v1.d.ts

@@ -108,12 +108,36 @@ export declare const protocolCodes: {
         readonly retryable: true;
         readonly httpStatus: 502;
     };
-    /** The root operation exited with a non-zero status or failed to run. */
+    /** The root program could not run, ended by a signal, or its output could not be kept. */
     readonly ROOT_FAILED: {
         readonly kind: "refusal";
         readonly retryable: false;
         readonly httpStatus: 500;
     };
+    /** The root program ran past its policy timeout and was killed. */
+    readonly ROOT_TIMEOUT: {
+        readonly kind: "refusal";
+        readonly retryable: true;
+        readonly httpStatus: 504;
+    };
+    /** The package already runs as many root programs as it may. */
+    readonly ROOT_BUSY: {
+        readonly kind: "refusal";
+        readonly retryable: true;
+        readonly httpStatus: 429;
+    };
+    /** Root output waiting in the staging folder already fills its quota. */
+    readonly ROOT_STAGING_FULL: {
+        readonly kind: "refusal";
+        readonly retryable: true;
+        readonly httpStatus: 507;
+    };
+    /** No root job of the package has this job_id. */
+    readonly ROOT_JOB_NOT_FOUND: {
+        readonly kind: "refusal";
+        readonly retryable: false;
+        readonly httpStatus: 404;
+    };
     /** DSM did not accept the Application Portal change; status portal says whether the entry needs another removal. */
     readonly PORTAL_FAILED: {
         readonly kind: "refusal";
@@ -246,7 +270,7 @@ export declare const protocolCodes: {
         readonly retryable: true;
         readonly httpStatus: 429;
     };
-    /** The file is larger than max_bytes. */
+    /** The file is larger than max_bytes, or root output is larger than its policy max_output. */
     readonly "limit-exceeded": {
         readonly kind: "refusal";
         readonly retryable: false;
@@ -344,7 +368,7 @@ export declare const protocolCodes: {
     };
 };
 export type ProtocolCode = keyof typeof protocolCodes;
-export type RefusalCode = "AUTH_DENIED" | "INELIGIBLE" | "APP_DENIED" | "ADMIN_REQUIRED" | "DELEGATION_DENIED" | "SCOPE_DENIED" | "POLICY_DENIED" | "PEER_DENIED" | "PERMISSION_DENIED" | "UNKNOWN_OP" | "INVALID_REQUEST" | "REQUEST_TOO_LARGE" | "EXECUTOR_PAUSED" | "STORAGE_ERROR" | "INTERNAL" | "WRITE_FAILED" | "READ_FAILED" | "DSM_FAILED" | "ROOT_FAILED" | "PORTAL_FAILED" | "NO_SPACE" | "SCOPE_APPROVAL_STALE" | "IDENTITY_CHANGED" | "needs-scope-confirmation" | "disabled" | "invalid-destination" | "invalid-size" | "operation-conflict" | "operation-not-found" | "destination-exists" | "invalid-path" | "path-too-deep" | "destination-not-directory" | "name-too-long" | "not-found" | "not-a-file" | "recursive-required" | "recycle-bin-disabled" | "task-not-found" | "too-many-tasks" | "queue-full" | "limit-exceeded";
+export type RefusalCode = "AUTH_DENIED" | "INELIGIBLE" | "APP_DENIED" | "ADMIN_REQUIRED" | "DELEGATION_DENIED" | "SCOPE_DENIED" | "POLICY_DENIED" | "PEER_DENIED" | "PERMISSION_DENIED" | "UNKNOWN_OP" | "INVALID_REQUEST" | "REQUEST_TOO_LARGE" | "EXECUTOR_PAUSED" | "STORAGE_ERROR" | "INTERNAL" | "WRITE_FAILED" | "READ_FAILED" | "DSM_FAILED" | "ROOT_FAILED" | "ROOT_TIMEOUT" | "ROOT_BUSY" | "ROOT_STAGING_FULL" | "ROOT_JOB_NOT_FOUND" | "PORTAL_FAILED" | "NO_SPACE" | "SCOPE_APPROVAL_STALE" | "IDENTITY_CHANGED" | "needs-scope-confirmation" | "disabled" | "invalid-destination" | "invalid-size" | "operation-conflict" | "operation-not-found" | "destination-exists" | "invalid-path" | "path-too-deep" | "destination-not-directory" | "name-too-long" | "not-found" | "not-a-file" | "recursive-required" | "recycle-bin-disabled" | "task-not-found" | "too-many-tasks" | "queue-full" | "limit-exceeded";
 export type OutcomeCode = "OPERATION_CANCELED" | "CANCEL_REQUESTED" | "CLEANUP_PENDING";
 export type ReasonCode = "grant-revoked" | "destination-replaced" | "integration-disabled" | "validation-denied" | "scope-changed" | "storage-error" | "operation-canceled-by-user" | "operation-deadline-exceeded";
 export type ClientCode = "EXECUTOR_UNAVAILABLE" | "EXECUTOR_TIMEOUT" | "EXECUTOR_TOO_LARGE" | "EXECUTOR_PROTOCOL";
@@ -485,9 +509,26 @@ export interface PortalRegisterParams {
 /** portal.unregister: Administrator: remove the App's Application Portal entry, its saved alias and every nginx conf DSM generated for it. Since 0.9.6. */
 export interface PortalUnregisterParams {
 }
-/** root.run: Administrator: run a root operation pinned by digest in the policy. Since 0.9.0. */
+/** root.jobs.get: Administrator whom Application Privileges allow to use the App: one root job with its state, latest progress and result. Since 0.10.0. */
+export interface RootJobsGetParams {
+    job_id: string;
+}
+/** root.jobs.list: Administrator whom Application Privileges allow to use the App: list the package's root jobs, newest first. Since 0.10.0. */
+export interface RootJobsListParams {
+}
+/** root.jobs.stop: Administrator whom Application Privileges allow to use the App: ask a running root job to cancel; it is killed after its grace. Since 0.10.0. */
+export interface RootJobsStopParams {
+    job_id: string;
+}
+/** root.run: Administrator whom Application Privileges allow to use the App: run a root program pinned by digest in the policy. Params reach the program on stdin as JSON, checked against the entry's schema; the reply carries its exit code, stderr and output, or a staging file for large output. Since 0.9.0. */
 export interface RootRunParams {
     name: string;
+    params?: Record<string, unknown>;
+}
+/** root.start: Administrator whom Application Privileges allow to use the App: start a root job, a pinned program with job limits, in the background. Params reach it on stdin; it reports progress on fd 5 and is told to cancel on fd 4. Since 0.10.0. */
+export interface RootStartParams {
+    name: string;
+    params?: Record<string, unknown>;
 }
 /** status: Executor readiness, protocol version, digests and the folder scope selection. Since 0.9.0. */
 export interface StatusParams {
@@ -517,7 +558,11 @@ export interface ProtocolParams {
     "files.write": FilesWriteParams;
     "portal.register": PortalRegisterParams;
     "portal.unregister": PortalUnregisterParams;
+    "root.jobs.get": RootJobsGetParams;
+    "root.jobs.list": RootJobsListParams;
+    "root.jobs.stop": RootJobsStopParams;
     "root.run": RootRunParams;
+    "root.start": RootStartParams;
     "status": StatusParams;
 }
 export type ProtocolOp = keyof ProtocolParams;

package/dist/src/shell/AppShell.vue.d.ts

@@ -1,20 +1,41 @@
-import type { ShellPage } from './pages';
+import { type WideLayout } from '@synopackageland/ui';
+import { type ShellContext } from '../context';
+import { type AppShellDenied, type AppShellPageEntry } from './app-pages';
 type __VLS_Props = {
     locale: string;
-    modelValue: ShellPage;
-    pages: readonly ShellPage[];
+    modelValue: string;
+    pages: readonly AppShellPageEntry[];
     description?: string;
+    ctx?: ShellContext;
+    wideLayout?: WideLayout;
+    sidebarStorageKey?: string;
+    brandName?: string;
+    brandIcon?: string;
+    keepScroll?: boolean;
+    pageWidth?: 'fill' | 'readable' | (string & {});
+    denied?: boolean | AppShellDenied;
+    appRoot?: boolean;
 };
-declare var __VLS_29: {}, __VLS_31: {};
-type __VLS_Slots = {} & {
-    actions?: (props: typeof __VLS_29) => any;
-} & {
-    default?: (props: typeof __VLS_31) => any;
+type __VLS_Slots = {
+    default?: (scope: {
+        page: string;
+    }) => unknown;
+    actions?: (scope: {
+        page: string;
+    }) => unknown;
+    toolbar?: (scope: {
+        page: string;
+    }) => unknown;
+    notices?: (scope: {
+        page: string;
+    }) => unknown;
+    'sidebar-footer'?: () => unknown;
+    denied?: () => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (value: ShellPage) => any;
+    "update:modelValue": (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: ((value: ShellPage) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/src/shell/app-pages.d.ts

@@ -0,0 +1,37 @@
+import type { Component } from 'vue';
+import type { AppSidebarGroup } from '@synopackageland/ui';
+import type { ShellCopy } from './i18n';
+import type { ShellPage } from './pages';
+export interface AppShellPage {
+    id: string;
+    /** Sidebar label and page title, already in the App's language. */
+    title: string;
+    icon?: Component;
+    /** Pages that share a label sit together under it, in first-seen order. */
+    group?: string;
+    badge?: string | number;
+    /** Rendered for this page; without one the default slot renders it. */
+    component?: Component;
+    /** Reachable through v-model but not listed in the sidebar. */
+    hidden?: boolean;
+    /** Replaces the shell's description for this page. */
+    description?: string;
+    /** false: the page draws its own header. */
+    header?: boolean;
+    /**
+     * The body fills the height under the header and the page does not scroll:
+     * the content scrolls itself (a treemap, a table paged by height, a log).
+     */
+    fill?: boolean;
+}
+export type AppShellPageEntry = ShellPage | AppShellPage;
+/** The page a denied shell shows; each field falls back to the shell's own words. */
+export interface AppShellDenied {
+    title?: string;
+    /** The default body; the denied slot replaces it. */
+    message?: string;
+    /** false: the denied slot draws its own header. */
+    header?: boolean;
+}
+export declare function resolvePages(entries: readonly AppShellPageEntry[], copy: ShellCopy): AppShellPage[];
+export declare function sidebarGroups(pages: readonly AppShellPage[]): AppSidebarGroup[];

package/dist/src/shell/i18n.d.ts

@@ -3,5 +3,9 @@ export type ShellCopy = typeof en;
 export declare const shellCatalogs: Record<import("..").UiLocale, {
     status: string;
     background: string;
+    administrator: string;
+    dsmUser: string;
+    deniedTitle: string;
+    deniedMessage: string;
 }>;
 export declare function shellCopy(locale: string): ShellCopy;

package/dist/src/shell/pages.d.ts

@@ -3,5 +3,10 @@ export interface ShellFeatureFlags {
     background?: boolean;
 }
 export declare function shellPages(features: ShellFeatureFlags): ShellPage[];
-/** Keeps a selection that still exists; otherwise the first page wins. */
-export declare function activePage(current: ShellPage | undefined, pages: readonly ShellPage[]): ShellPage;
+/** A page id, or an App's page with an id that may be left out of the sidebar. */
+export type PageRef<T extends string = string> = T | {
+    readonly id: T;
+    readonly hidden?: boolean;
+};
+/** Keeps a selection that still exists; otherwise the first page the sidebar shows wins. */
+export declare function activePage<T extends string>(current: string | undefined, pages: readonly PageRef<T>[]): T;

package/dist/src/shell/slot-content.d.ts

@@ -0,0 +1,2 @@
+/** Whether a slot's vnodes show anything: not only v-if comments and whitespace, also inside fragments. */
+export declare function hasContent(nodes: unknown): boolean;