@openchamber/sdk 2.5.3 → 2.6.0

package/dist/index.js

@@ -6,11 +6,12 @@ export { GUEST_SHELL_END_STATUSES, GUEST_SHELL_ID_MAX, GUEST_SHELLS_MAX, GUEST_S
 export { GUEST_STATUS_CONTROLS_MAX, GUEST_STATUS_CONTROL_ID, GUEST_STATUS_CONTROL_LABEL_MAX, GUEST_STATUS_CONTROL_OPTIONS_MAX, GUEST_STATUS_CONTROL_VALUE_MAX } from './status-controls.js';
 export { GUEST_STATUS_SOURCE_INTERVAL_DEFAULT, GUEST_STATUS_SOURCE_INTERVAL_MAX, GUEST_STATUS_SOURCE_INTERVAL_MIN, GUEST_STATUS_VIEW_ACTIONS_MAX, GUEST_STATUS_VIEW_CHART_POINTS_MAX, GUEST_STATUS_VIEW_CHIPS_MAX, GUEST_STATUS_VIEW_ICON, GUEST_STATUS_VIEW_NOTE_MAX, GUEST_STATUS_VIEW_ROWS_MAX, GUEST_STATUS_VIEW_SEGMENTS_MAX, GUEST_STATUS_VIEW_SEGMENTS_MIN, GUEST_STATUS_VIEW_TEXT_MAX, } from './status-view.js';
 export { compareOpenChamberVersions, hostMeetsOpenChamberEngine, openChamberEngineMinimum, OPENCHAMBER_ENGINE_PATTERN, parseOpenChamberVersion, } from './host-version.js';
-export { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_CAPABILITIES, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_TOOLS_MAX, GUEST_TOOL_COLUMNS_MAX, GUEST_TOOL_COLUMN_MAX, GUEST_TOOL_LANGUAGE_MAX, GUEST_TOOL_MATCH, GUEST_TOOL_MATCH_MAX, GUEST_TOOL_NAME_MAX, GUEST_TOOL_OUTPUTS, GUEST_TOOL_TEMPLATE_MAX, GUEST_TOOL_TEMPLATE_VALUE_MAX, guestActionsNeedConversation, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_DEFAULT, GUEST_SURFACE_DOCK_SIZE_DEFAULT, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_DEFAULT, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, clampStatusSectionHeight, HOST_LINEAR_API_ORIGIN, isGuestFilesystemPattern, hasGuestCapability, hasGuestPage, isGuestApproved, isGuestPackageSvgIcon, requestedGuestCapabilities, resolveAttachEntry, resolvePageEntry, resolveStatusSectionEntry, resolveStatusSectionSource, resolveAttachMode, resolveIntegrationApi, resolveIntegrationAuth, serviceProvides, SOURCE_CONTROL_DEFAULT_INSTANCES_MAX, SOURCE_CONTROL_GUEST_ID_MAX, SOURCE_CONTROL_URL_TEMPLATES_MAX, SOURCE_CONTROL_URL_TEMPLATE_MAX, SOURCE_CONTROL_URL_TOKENS, sourceControlProviderIdOf, toPublicService, toPublicSourceControl, toPublicIntegration, } from './manifest.js';
+export { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_CAPABILITIES, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_TOOLS_MAX, GUEST_TOOL_COLUMNS_MAX, GUEST_TOOL_COLUMN_MAX, GUEST_TOOL_LANGUAGE_MAX, GUEST_TOOL_MATCH, GUEST_TOOL_MATCH_MAX, GUEST_TOOL_NAME_MAX, GUEST_TOOL_OUTPUTS, GUEST_TOOL_TEMPLATE_MAX, GUEST_TOOL_TEMPLATE_VALUE_MAX, guestActionsNeedConversation, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_DEFAULT, GUEST_SURFACE_DOCK_SIZE_DEFAULT, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_DEFAULT, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, clampStatusSectionHeight, HOST_LINEAR_API_ORIGIN, isGuestFilesystemPattern, hasGuestCapability, hasGuestPage, isGuestApproved, isGuestPackageSvgIcon, NOTIFICATIONS_GUEST_ID_MAX, notificationProviderIdOf, requestedGuestCapabilities, resolveAttachEntry, resolvePageEntry, resolveStatusSectionEntry, resolveStatusSectionSource, resolveAttachMode, resolveIntegrationApi, resolveIntegrationAuth, serviceProvides, SOURCE_CONTROL_DEFAULT_INSTANCES_MAX, SOURCE_CONTROL_GUEST_ID_MAX, SOURCE_CONTROL_URL_TEMPLATES_MAX, SOURCE_CONTROL_URL_TEMPLATE_MAX, SOURCE_CONTROL_URL_TOKENS, sourceControlProviderIdOf, toPublicNotifications, toPublicService, toPublicSessionEvents, toPublicSourceControl, toPublicIntegration, toPublicTracker, TRACKER_BASE_STATE_FILTERS, TRACKER_GUEST_ID_MAX, TRACKER_IDENTIFIER_KINDS, TRACKER_STATE_FILTERS_MAX, TRACKER_URL_TEMPLATES_MAX, TRACKER_URL_TEMPLATE_MAX, TRACKER_URL_TOKENS, isTrackerUrlTemplate, trackerProviderIdOf, } from './manifest.js';
+export { GUEST_SESSION_EVENT_TYPES, SESSION_EVENT_ERROR_MAX, SESSION_EVENT_PENDING_MAX, SESSION_EVENT_REPLY_MAX, SESSION_EVENT_TIMEOUT_MS, SESSION_EVENTS_IDLE_MS, SESSION_EVENTS_PATH, SESSION_EVENTS_WIRE_VERSION, isGuestSessionEventType, readSessionEventRequest, } from './session-events.js';
 export { GUEST_FILE_EDITORS_MAX, GUEST_FILE_EDITOR_CONTENT_MAX, GUEST_FILE_EDITOR_PATTERNS_MAX, GUEST_FILE_EDITOR_PATTERN_MAX, GUEST_FILE_EDITOR_TITLE_MAX, GUEST_FILE_EDITOR_VERSION_MAX, createFileSaveTracker, fileEditorPayloadSize, isFileEditorPattern, matchesFileEditorPattern, } from './file-editor.js';
 export { connectHost, HostRequestError } from './host.js';
 export { GUEST_POPOVER_COORDINATE_MAX, GUEST_POPOVER_DATA_DEPTH_MAX, GUEST_POPOVER_DATA_MAX, GUEST_POPOVER_HEIGHT_MAX, GUEST_POPOVER_HEIGHT_MIN, GUEST_POPOVER_ID, GUEST_POPOVER_SIDES, GUEST_POPOVER_WIDTH_MAX, GUEST_POPOVER_WIDTH_MIN, GUEST_POPOVER_CLOSE_REASONS, isGuestPopoverRequest, } from './popover.js';
 export { clampAttachRequest, clampBadgeCount, clampFrameHeight, isGuestCommitSha, GUEST_COMMIT_SHA, clampPromptRequest, clampStartSessionRequest, guestFileScope, isAttachData, isJsonValue, isFileListResult, isFileReadResult, isFileStatResult, isGenerateResult, isFileWriteResult, isGuestFilePath, isGuestAttachItem, isGuestMessageItem, isGuestSessionItem, isServiceStatusResult, isGuestRequestPath, isGuestRequestResult, isHostRequestErrorCode, isPromptResult, isStartSessionResult, readHostMessage, resolveHostRequestErrorCode, } from './contract.js';
 export { EMPTY_GUEST_CONNECTION, GUEST_BADGE_MAX, GUEST_FRAME_HEIGHT_MAX, GUEST_ITEM_MESSAGE_TEXT_MAX, GUEST_ITEM_SESSION_MAX, GUEST_RESOLVE_ERROR_MAX, GUEST_FILE_CONTENT_MAX, GUEST_FILE_ENTRY_KINDS, GUEST_FILE_LIST_MAX, GUEST_FILE_PATH_MAX, GUEST_GENERATE_OUTPUT_TOKENS_MAX, GUEST_GENERATE_PROMPT_MAX, GUEST_GENERATE_SYSTEM_MAX, GUEST_GENERATE_TEXT_MAX, GUEST_GENERATE_TIMEOUT_MS, GUEST_GENERATE_LATE_KEEP_MS, GUEST_GENERATE_LATE_MAX, GUEST_FILE_STAT_KINDS, SERVICE_STATUS_VALUES, HOST_REQUEST_ERROR_CODES, SESSION_LIFECYCLE_PHASES, START_SESSION_SENT, GUEST_ACCOUNT_MAX, GUEST_SESSION_AGENT_MAX, GUEST_SESSION_MODEL_MAX, GUEST_ATTACH_AUTHOR_MAX, GUEST_ATTACH_BRANCH_MAX, GUEST_ATTACH_DATA_MAX, GUEST_ATTACH_ID_MAX, GUEST_ATTACH_TEXT_MAX, GUEST_ATTACH_TITLE_MAX, GUEST_ATTACH_URL_MAX, GUEST_CLIPBOARD_TEXT_MAX, GUEST_TOAST_MAX, GUEST_COMPOSE_TEXT_MAX, GUEST_REQUEST_BODY_MAX, GUEST_REQUEST_PATH_MAX, GUEST_REQUEST_RESPONSE_MAX, GUEST_REQUEST_TIMEOUT_MS, GUEST_SETTING_VALUE_MAX, } from './contract.js';
-export { BROWSER_CONTROL_ACTIONS, BROWSER_PROVIDER_ACTION_TIMEOUT_MS, BROWSER_PROVIDER_IDLE_MS, BROWSER_PROVIDER_OPEN_TIMEOUT_MS, BROWSER_PROVIDER_PATH, BROWSER_PROVIDER_RESPONSE_MAX, BROWSER_SCROLL_DIRECTIONS, BROWSER_VIEWPORT_MODES, isBrowserControlAction, readBrowserProviderRequest, OPENCHAMBER_HOST_CALLBACK_URL, SOURCE_CONTROL_OUTBOUND_BODY_MAX, SOURCE_CONTROL_OUTBOUND_METHODS, SOURCE_CONTROL_OUTBOUND_PATH, SOURCE_CONTROL_OUTBOUND_REQUEST_HEADERS, SOURCE_CONTROL_OUTBOUND_RESPONSE_HEADERS, SOURCE_CONTROL_OUTBOUND_RESPONSE_HEADER_PREFIX, SOURCE_CONTROL_OUTBOUND_RESPONSE_MAX, SOURCE_CONTROL_OUTBOUND_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_AUTH_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_ERROR_MESSAGE_MAX, SOURCE_CONTROL_PROVIDER_IDLE_MS, SOURCE_CONTROL_PROVIDER_METHODS, SOURCE_CONTROL_PROVIDER_MUTATION_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_PATH, SOURCE_CONTROL_PROVIDER_READ_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_RESPONSE_MAX, SOURCE_CONTROL_PROVIDER_STATUS_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_TARGET_MAX, SOURCE_CONTROL_PROVIDER_WIRE_VERSION, SourceControlForgeError, createSourceControlForge, isSourceControlProviderMethod, readSourceControlProviderRequest, sourceControlProviderTimeoutMs, } from './service-providers.js';
+export { BROWSER_CONTROL_ACTIONS, BROWSER_PROVIDER_ACTION_TIMEOUT_MS, BROWSER_PROVIDER_IDLE_MS, BROWSER_PROVIDER_OPEN_TIMEOUT_MS, BROWSER_PROVIDER_PATH, BROWSER_PROVIDER_RESPONSE_MAX, BROWSER_SCROLL_DIRECTIONS, BROWSER_VIEWPORT_MODES, isBrowserControlAction, readBrowserProviderRequest, OPENCHAMBER_HOST_CALLBACK_URL, SOURCE_CONTROL_OUTBOUND_BODY_MAX, SOURCE_CONTROL_OUTBOUND_METHODS, SOURCE_CONTROL_OUTBOUND_PATH, SOURCE_CONTROL_OUTBOUND_REQUEST_HEADERS, SOURCE_CONTROL_OUTBOUND_RESPONSE_HEADERS, SOURCE_CONTROL_OUTBOUND_RESPONSE_HEADER_PREFIX, SOURCE_CONTROL_OUTBOUND_RESPONSE_MAX, SOURCE_CONTROL_OUTBOUND_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_AUTH_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_ERROR_MESSAGE_MAX, SOURCE_CONTROL_PROVIDER_IDLE_MS, SOURCE_CONTROL_PROVIDER_METHODS, SOURCE_CONTROL_PROVIDER_MUTATION_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_PATH, SOURCE_CONTROL_PROVIDER_READ_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_RESPONSE_MAX, SOURCE_CONTROL_PROVIDER_STATUS_TIMEOUT_MS, SOURCE_CONTROL_PROVIDER_TARGET_MAX, SOURCE_CONTROL_PROVIDER_WIRE_VERSION, SourceControlForgeError, createSourceControlForge, isSourceControlProviderMethod, readSourceControlProviderRequest, sourceControlProviderTimeoutMs, GUEST_NOTIFICATION_KINDS, NOTIFICATIONS_OUTBOUND_PATH, NOTIFICATIONS_OUTBOUND_TIMEOUT_MS, NOTIFICATIONS_PROVIDER_AUTH_TIMEOUT_MS, NOTIFICATIONS_PROVIDER_ERROR_MESSAGE_MAX, NOTIFICATIONS_PROVIDER_IDLE_MS, NOTIFICATIONS_PROVIDER_METHODS, NOTIFICATIONS_PROVIDER_NOTIFY_TIMEOUT_MS, NOTIFICATIONS_PROVIDER_PATH, NOTIFICATIONS_PROVIDER_RESPONSE_MAX, NOTIFICATIONS_PROVIDER_WIRE_VERSION, NotificationsOutboundError, createNotificationsOutbound, isNotificationsProviderMethod, notificationsProviderTimeoutMs, readNotificationsProviderRequest, TRACKER_OUTBOUND_PATH, TRACKER_OUTBOUND_TIMEOUT_MS, TRACKER_PROVIDER_AUTH_TIMEOUT_MS, TRACKER_PROVIDER_CONTAINERS_MAX, TRACKER_PROVIDER_ERROR_MESSAGE_MAX, TRACKER_PROVIDER_IDLE_MS, TRACKER_PROVIDER_LIST_MAX, TRACKER_PROVIDER_LIVE_SUMMARIES_MAX, TRACKER_PROVIDER_METHODS, TRACKER_PROVIDER_PATH, TRACKER_PROVIDER_READ_TIMEOUT_MS, TRACKER_PROVIDER_RESPONSE_MAX, TRACKER_PROVIDER_WIRE_VERSION, TRACKER_PROVIDER_WRITE_METHODS, TRACKER_PROVIDER_WRITE_TIMEOUT_MS, TrackerOutboundError, createTrackerOutbound, isTrackerProviderMethod, isTrackerProviderWriteMethod, readTrackerProviderRequest, trackerProviderTimeoutMs, } from './service-providers.js';
 export { SURFACE_AGENT_ACTIVE_HEADER, SURFACE_AGENT_HOLD_MS, SURFACE_CLIPBOARD_PATH, SURFACE_CONTROL_PATH, SURFACE_CONTROLLERS, SURFACE_DIMENSION_MAX, SURFACE_FRAME_MAX_BYTES, SURFACE_FRAME_MIMES, SURFACE_FRAME_PATH, SURFACE_FRAME_SEQ_HEADER, SURFACE_FRAME_WAIT_MS, SURFACE_HEIGHT_HEADER, SURFACE_INPUT_BATCH_MAX, SURFACE_INPUT_PATH, SURFACE_RESIZE_PATH, SURFACE_SEQ_HEADER, SURFACE_TEXT_MAX, SURFACE_TITLE_HEADER, SURFACE_TITLE_MAX, SURFACE_VIEWER_CONTROLS_HEADER, SURFACE_VIEWER_HEADER, SURFACE_WIDTH_HEADER, readSurfaceControlNotice, readSurfaceInputBatch, readSurfaceResizeRequest, } from './service-surface.js';

package/dist/manifest.d.ts

@@ -1,6 +1,7 @@
 import type { OpenChamberManifestApiVersion } from './api-version.ts';
 import type { FileEditorContribution } from './file-editor.ts';
 import { type StatusSectionSource } from './status-view.ts';
+import type { PublicSessionEvents, SessionEventsContribution } from './session-events.ts';
 export declare const PANEL_ID: RegExp;
 /**
  * The extension's identity on the rail, the Extensions card, and the approval
@@ -250,11 +251,15 @@ export type PublicSocketBinding = {
  * Host roles a service can stand in for. `browser` answers the agent's
  * `browser.*` actions in place of the in-app browser view. `source-control`
  * makes the extension a Git host next to GitHub, GitLab and Gitea, described
- * by `contributes.sourceControl`. Both contracts are in `service-providers.ts`.
+ * by `contributes.sourceControl`. `notifications` makes it a delivery channel
+ * for the user's notifications next to the desktop and the phone, described
+ * by `contributes.notifications`. `tracker` makes it a work item tracker next
+ * to Linear, described by `contributes.tracker`; an extension is a Git host
+ * or a tracker, never both. The contracts are in `service-providers.ts`.
  * A service that provides a role needs no panel or background entry: the host
  * starts it on the first call.
  */
-export declare const GUEST_SERVICE_PROVIDES: readonly ['browser', 'source-control'];
+export declare const GUEST_SERVICE_PROVIDES: readonly ['browser', 'source-control', 'notifications', 'tracker'];
 export type GuestServiceProvides = (typeof GUEST_SERVICE_PROVIDES)[number];
 /**
  * The host names an extension's Git host `ext-<panel.id>`, and provider ids
@@ -264,6 +269,217 @@ export type GuestServiceProvides = (typeof GUEST_SERVICE_PROVIDES)[number];
 export declare const SOURCE_CONTROL_GUEST_ID_MAX = 28;
 /** The provider id OpenChamber gives the Git host an extension provides. */
 export declare const sourceControlProviderIdOf: (guestId: string) => string;
+/** The notification channel is named `ext-<panel.id>` the same way, within the same 32 characters. */
+export declare const NOTIFICATIONS_GUEST_ID_MAX = 28;
+/** The provider id OpenChamber gives the notification channel an extension provides. */
+export declare const notificationProviderIdOf: (guestId: string) => string;
+/**
+ * `contributes.notifications`: the delivery channel an extension with
+ * `service.provides: ["notifications"]` adds, declared in the manifest so
+ * OpenChamber can draw its account card and route to it without starting the
+ * service. The account is OpenChamber's: the user connects it in Settings →
+ * Integrations, the token stays in OpenChamber, and the service reaches the
+ * channel's server through OpenChamber's outbound proxy with a per-call handle.
+ */
+export type NotificationsContribution = {
+    /** The channel's name on its account card, shown untranslated. 1 to 64 characters. */
+    label: string;
+    /**
+     * Where every account lives: one `fixed` https origin (Slack's API), or an
+     * origin the `user` types when connecting (a Matrix homeserver), with the
+     * field's label and an optional example.
+     */
+    instances: {
+        kind: 'fixed';
+        origin: string;
+    } | {
+        kind: 'user';
+        label: string;
+        placeholder?: string;
+    };
+    /** How OpenChamber sends the token: which header, with which prefix. Same rules as `contributes.sourceControl.token`. */
+    token: {
+        header: 'authorization' | 'private-token';
+        scheme: 'bearer' | 'token' | 'basic' | 'none';
+        /** Settings asks for the account's username beside the token. Required with, and only with, `basic`. */
+        username?: boolean;
+        /** Scopes the Settings card asks the user to grant. */
+        scopes?: string[];
+        /** Path on the instance where tokens are created, linked from Settings. */
+        createPath?: string;
+    };
+};
+/** What the extension catalog and approval dialog show of the channel; never a token. */
+export type PublicNotifications = {
+    label: string;
+    instances: {
+        kind: 'fixed';
+        origin: string;
+    } | {
+        kind: 'user';
+        label: string;
+        placeholder?: string;
+    };
+    token: {
+        scheme: 'bearer' | 'token' | 'basic' | 'none';
+        username: boolean;
+        scopes: string[];
+        createPath?: string;
+    };
+};
+export declare const toPublicNotifications: (contribution: NotificationsContribution) => PublicNotifications;
+/** The tracker is named `ext-<panel.id>` the same way, within the same 32 characters. */
+export declare const TRACKER_GUEST_ID_MAX = 28;
+/** The provider id OpenChamber gives the tracker an extension provides. */
+export declare const trackerProviderIdOf: (guestId: string) => string;
+/** Link templates per tracker (`contributes.tracker.urls.item`). */
+export declare const TRACKER_URL_TEMPLATES_MAX = 8;
+/** Characters in one link template. */
+export declare const TRACKER_URL_TEMPLATE_MAX = 256;
+/**
+ * The placeholders a link template may use. `{id}` is the item's identifier,
+ * exactly once, in the path or as a query value (`?selectedIssue={id}`);
+ * `{segment}` is any one path segment; `{segments+}` one or more (a
+ * self-hosted server's prefix), at most once per template.
+ */
+export declare const TRACKER_URL_TOKENS: readonly ['{id}', '{segment}', '{segments+}'];
+/**
+ * A link template of a tracker item: `/`, segments that are each a literal or
+ * one of `TRACKER_URL_TOKENS`, and optionally `?name={id}`. `{id}` appears
+ * exactly once, in the path or as the query value; `{segments+}` at most once.
+ * The host compiles it into the pattern that recognises a pasted link; an
+ * extension never supplies a regular expression.
+ */
+export declare const isTrackerUrlTemplate: (value: string) => boolean;
+/** State filters every tracker offers, first in the menu; the rest are the tracker's own. */
+export declare const TRACKER_BASE_STATE_FILTERS: readonly ['open', 'all'];
+/** Filters a tracker may add past the base ones: the six neutral categories, then its own ids. */
+export declare const TRACKER_STATE_FILTERS_MAX = 16;
+/**
+ * The shape of an item's identifier, which OpenChamber compares
+ * case-insensitively everywhere (links, tracked items, session links):
+ * `key-number` is `PROJ-42` (Jira, YouTrack, Linear), `number` a bare number
+ * (Azure DevOps, Redmine), `short-code` letters and digits (Trello, ClickUp).
+ */
+export declare const TRACKER_IDENTIFIER_KINDS: readonly ['key-number', 'number', 'short-code'];
+export type TrackerIdentifierKind = (typeof TRACKER_IDENTIFIER_KINDS)[number];
+/** The token block of a tracker, the Git host's rules. */
+export type TrackerTokenAuth = {
+    header: 'authorization' | 'private-token';
+    scheme: 'bearer' | 'token' | 'basic' | 'none';
+    /** Settings asks for the account's username beside the token. Required with, and only with, `basic`. */
+    username?: boolean;
+    /** Scopes the Settings card asks the user to grant. */
+    scopes?: string[];
+    /** Path on the instance where tokens are created, linked from Settings. */
+    createPath?: string;
+};
+/**
+ * OAuth with PKCE, run by OpenChamber: the user enters the client id (and a
+ * secret, when the tracker issues one) on the card, signs in in the browser,
+ * and OpenChamber keeps the tokens. `authorizeUrl` and `tokenUrl` are https
+ * URLs, or paths on the instance (`/hub/api/rest/oauth2/auth`) for a tracker
+ * whose server the user names.
+ */
+export type TrackerOAuth = {
+    authorizeUrl: string;
+    tokenUrl: string;
+    scopes?: string[];
+};
+/**
+ * What the tracker can do. A capability left out is off. Host access (an SDK
+ * guest borrowing the token) is not declared: the host keeps it off for every
+ * extension, because the service itself never sees a token.
+ */
+export type TrackerCapabilities = {
+    multipleAccounts: boolean;
+    /** `items.updateState` and `states.list` are called. */
+    stateUpdate: boolean;
+    children: boolean;
+    labels: boolean;
+    priority: boolean;
+    filters: {
+        people: boolean;
+        priority: boolean;
+    };
+    /** `containers.list` is called, and Settings maps containers to projects. */
+    projectMapping: boolean;
+    /** `comments.create` is called with "session started / completed / failed" and a link. */
+    sessionComments: boolean;
+};
+/**
+ * `contributes.tracker`: the work item tracker an extension with
+ * `service.provides: ["tracker"]` adds next to Linear, declared in the manifest
+ * so OpenChamber can list it, draw its account card and recognise its links
+ * without starting the service. The provider id is not declared: OpenChamber
+ * names it `ext-<panel.id>`. Accounts and tokens are OpenChamber's; the
+ * service reaches the tracker's server through OpenChamber's outbound proxy
+ * with a per-call handle.
+ */
+export type TrackerContribution = {
+    /** Wire version of the role's service contract; `1`. */
+    wire: 1;
+    /** The product name, shown untranslated. 1 to 64 characters. */
+    label: string;
+    /**
+     * Where the accounts live: one `fixed` https origin (a cloud tracker with
+     * one address), or an origin the `user` types when connecting (a self-hosted
+     * server, a per-company site), with the field's label and an optional example.
+     */
+    instances: {
+        kind: 'fixed';
+        origin: string;
+    } | {
+        kind: 'user';
+        label: string;
+        placeholder?: string;
+    };
+    /** How the user signs in: a pasted token, OAuth, or either. At least one. */
+    auth: {
+        token?: TrackerTokenAuth;
+        oauth?: TrackerOAuth;
+    };
+    capabilities: TrackerCapabilities;
+    /**
+     * In menu order: `open` and `all` first, then the neutral categories the
+     * tracker offers (`triage`, `backlog`, `todo`, `in-progress`, `done`,
+     * `canceled`) and its own filter ids (`inReview`). What `items.list` is asked for.
+     */
+    stateFilters: string[];
+    identifier: TrackerIdentifierKind;
+    /**
+     * Link templates of one item on the instance, made of literal segments and
+     * the `TRACKER_URL_TOKENS` placeholders, such as `/browse/{id}` or
+     * `/{segments+}?selectedIssue={id}`. OpenChamber compiles them; an extension
+     * never supplies a regular expression.
+     */
+    urls: {
+        item: string[];
+    };
+};
+/** What the extension catalog, the approval dialog and the account card show of the tracker; never a token. */
+export type PublicTracker = {
+    label: string;
+    instances: {
+        kind: 'fixed';
+        origin: string;
+    } | {
+        kind: 'user';
+        label: string;
+        placeholder?: string;
+    };
+    authMethods: Array<'oauth' | 'token'>;
+    token?: {
+        scheme: 'bearer' | 'token' | 'basic' | 'none';
+        username: boolean;
+        scopes: string[];
+        createPath?: string;
+    };
+    oauth?: {
+        scopes: string[];
+    };
+};
+export declare const toPublicTracker: (contribution: TrackerContribution) => PublicTracker;
 /** Default instances a Git host extension may name. */
 export declare const SOURCE_CONTROL_DEFAULT_INSTANCES_MAX = 4;
 /** URL templates per kind (`presentation.urls.changeRequest` / `.issue`). */
@@ -456,9 +672,11 @@ export declare const serviceProvides: (service: Pick<ServiceContribution, 'provi
  * `shells` are declared under `contributes.capabilities`; `service`, `network`,
  * `filesystem` and `origins` follow from `contributes.service`,
  * `contributes.integration`, `contributes.filesystem` and `contributes.origins`. `model` is one-off text generation with the
- * user's Small Model (`host.generate`), outside any session.
+ * user's Small Model (`host.generate`), outside any session. `transcript`
+ * follows from `contributes.sessionEvents.content`: the service receives what
+ * the agent said or asked, not only that it did.
  */
-export declare const GUEST_CAPABILITIES: readonly ['prompt', 'sessions', 'files', 'model', 'shells', 'conversation', 'service', 'network', 'filesystem', 'origins'];
+export declare const GUEST_CAPABILITIES: readonly ['prompt', 'sessions', 'files', 'model', 'shells', 'conversation', 'service', 'network', 'filesystem', 'origins', 'transcript'];
 export type GuestCapability = (typeof GUEST_CAPABILITIES)[number];
 export declare const DECLARED_GUEST_CAPABILITIES: readonly ['prompt', 'sessions', 'files', 'model', 'shells'];
 /** The capabilities a manifest may ask for directly. */
@@ -502,6 +720,12 @@ export type OpenChamberContributes = {
     fileEditors?: FileEditorContribution[];
     /** The Git host a `source-control` service provides; present exactly when it does. */
     sourceControl?: SourceControlContribution;
+    /** Session events OpenChamber posts to the service (`session-events.ts`). Needs `service`. */
+    sessionEvents?: SessionEventsContribution;
+    /** The notification channel a `notifications` service provides; present exactly when it does. */
+    notifications?: NotificationsContribution;
+    /** The work item tracker a `tracker` service provides; present exactly when it does. */
+    tracker?: TrackerContribution;
 };
 /** Whether any declared action asks for a session's messages, which needs `conversation`. */
 export declare const guestActionsNeedConversation: (actions: readonly GuestActionContribution[] | undefined) => boolean;
@@ -510,7 +734,9 @@ export type PublicGuestCapabilities = {
     requested: GuestCapability[];
     granted: GuestCapability[];
 };
-export declare const requestedGuestCapabilities: (contributes: Pick<OpenChamberContributes, 'capabilities' | 'integration' | 'service' | 'filesystem' | 'actions' | 'origins'>) => GuestCapability[];
+export declare const requestedGuestCapabilities: (contributes: Pick<OpenChamberContributes, 'capabilities' | 'integration' | 'service' | 'filesystem' | 'actions' | 'origins' | 'sessionEvents'>) => GuestCapability[];
+/** What the catalog and the approval dialog show of `contributes.sessionEvents`. */
+export declare const toPublicSessionEvents: (contribution: SessionEventsContribution) => PublicSessionEvents;
 /**
  * Whether the package ships a visible panel. Background-only extensions can
  * execute code but have no rail surface, attach picker, or full-screen page.
@@ -543,7 +769,7 @@ export type OpenChamberManifest = {
     engines?: OpenChamberEngines;
     contributes: OpenChamberContributes;
 };
-export type ParseManifestErrorCode = 'not-object' | 'missing-openchamber' | 'unsupported-api-version' | 'invalid-engines' | 'invalid-version' | 'missing-panel' | 'invalid-panel' | 'invalid-panel-id' | 'invalid-panel-name' | 'invalid-panel-icon' | 'invalid-panel-entry' | 'invalid-background' | 'invalid-attach' | 'invalid-page' | 'invalid-status-section' | 'invalid-capabilities' | 'invalid-integration' | 'invalid-service' | 'invalid-filesystem' | 'invalid-origins' | 'invalid-actions' | 'invalid-commands' | 'invalid-tools' | 'invalid-file-editors';
+export type ParseManifestErrorCode = 'not-object' | 'missing-openchamber' | 'unsupported-api-version' | 'invalid-engines' | 'invalid-version' | 'missing-panel' | 'invalid-panel' | 'invalid-panel-id' | 'invalid-panel-name' | 'invalid-panel-icon' | 'invalid-panel-entry' | 'invalid-background' | 'invalid-attach' | 'invalid-page' | 'invalid-status-section' | 'invalid-session-events' | 'invalid-capabilities' | 'invalid-integration' | 'invalid-service' | 'invalid-filesystem' | 'invalid-origins' | 'invalid-actions' | 'invalid-commands' | 'invalid-tools' | 'invalid-file-editors';
 export type ParseManifestFailure = {
     ok: false;
     code: ParseManifestErrorCode;

package/dist/manifest.js

@@ -90,11 +90,15 @@ export const resolveIntegrationApi = (integration) => {
  * Host roles a service can stand in for. `browser` answers the agent's
  * `browser.*` actions in place of the in-app browser view. `source-control`
  * makes the extension a Git host next to GitHub, GitLab and Gitea, described
- * by `contributes.sourceControl`. Both contracts are in `service-providers.ts`.
+ * by `contributes.sourceControl`. `notifications` makes it a delivery channel
+ * for the user's notifications next to the desktop and the phone, described
+ * by `contributes.notifications`. `tracker` makes it a work item tracker next
+ * to Linear, described by `contributes.tracker`; an extension is a Git host
+ * or a tracker, never both. The contracts are in `service-providers.ts`.
  * A service that provides a role needs no panel or background entry: the host
  * starts it on the first call.
  */
-export const GUEST_SERVICE_PROVIDES = ['browser', 'source-control'];
+export const GUEST_SERVICE_PROVIDES = ['browser', 'source-control', 'notifications', 'tracker'];
 /**
  * The host names an extension's Git host `ext-<panel.id>`, and provider ids
  * are at most 32 characters, so a guest taking the role has an id of at most
@@ -103,6 +107,99 @@ export const GUEST_SERVICE_PROVIDES = ['browser', 'source-control'];
 export const SOURCE_CONTROL_GUEST_ID_MAX = 28;
 /** The provider id OpenChamber gives the Git host an extension provides. */
 export const sourceControlProviderIdOf = (guestId) => `ext-${guestId}`;
+/** The notification channel is named `ext-<panel.id>` the same way, within the same 32 characters. */
+export const NOTIFICATIONS_GUEST_ID_MAX = 28;
+/** The provider id OpenChamber gives the notification channel an extension provides. */
+export const notificationProviderIdOf = (guestId) => `ext-${guestId}`;
+export const toPublicNotifications = (contribution) => {
+    const token = {
+        scheme: contribution.token.scheme,
+        username: contribution.token.username === true,
+        scopes: [...(contribution.token.scopes ?? [])],
+    };
+    if (contribution.token.createPath)
+        token.createPath = contribution.token.createPath;
+    return { label: contribution.label, instances: { ...contribution.instances }, token };
+};
+/** The tracker is named `ext-<panel.id>` the same way, within the same 32 characters. */
+export const TRACKER_GUEST_ID_MAX = 28;
+/** The provider id OpenChamber gives the tracker an extension provides. */
+export const trackerProviderIdOf = (guestId) => `ext-${guestId}`;
+/** Link templates per tracker (`contributes.tracker.urls.item`). */
+export const TRACKER_URL_TEMPLATES_MAX = 8;
+/** Characters in one link template. */
+export const TRACKER_URL_TEMPLATE_MAX = 256;
+/**
+ * The placeholders a link template may use. `{id}` is the item's identifier,
+ * exactly once, in the path or as a query value (`?selectedIssue={id}`);
+ * `{segment}` is any one path segment; `{segments+}` one or more (a
+ * self-hosted server's prefix), at most once per template.
+ */
+export const TRACKER_URL_TOKENS = ['{id}', '{segment}', '{segments+}'];
+// A literal template segment: no placeholder braces, no regex syntax.
+const TRACKER_URL_TEMPLATE_LITERAL = /^[A-Za-z0-9._~-]+$/;
+const TRACKER_URL_TOKEN_SET = new Set(TRACKER_URL_TOKENS);
+// `?name={id}`: the query parameter that carries the identifier.
+const TRACKER_QUERY_TEMPLATE = /^([A-Za-z0-9_.-]{1,64})=\{id\}$/;
+/**
+ * A link template of a tracker item: `/`, segments that are each a literal or
+ * one of `TRACKER_URL_TOKENS`, and optionally `?name={id}`. `{id}` appears
+ * exactly once, in the path or as the query value; `{segments+}` at most once.
+ * The host compiles it into the pattern that recognises a pasted link; an
+ * extension never supplies a regular expression.
+ */
+export const isTrackerUrlTemplate = (value) => {
+    if (!value.startsWith('/') || value.length > TRACKER_URL_TEMPLATE_MAX)
+        return false;
+    const queryAt = value.indexOf('?');
+    const pathPart = queryAt === -1 ? value : value.slice(0, queryAt);
+    const queryPart = queryAt === -1 ? null : value.slice(queryAt + 1);
+    const segments = pathPart === '/' ? [] : pathPart.slice(1).split('/');
+    if (segments.some((segment) => segment === '.' || segment === '..'))
+        return false;
+    if (segments.some((segment) => !TRACKER_URL_TOKEN_SET.has(segment) && !TRACKER_URL_TEMPLATE_LITERAL.test(segment)))
+        return false;
+    const count = (token) => segments.filter((segment) => segment === token).length;
+    if (count('{segments+}') > 1)
+        return false;
+    if (queryPart === null)
+        return count('{id}') === 1;
+    return TRACKER_QUERY_TEMPLATE.test(queryPart) && count('{id}') === 0;
+};
+/** State filters every tracker offers, first in the menu; the rest are the tracker's own. */
+export const TRACKER_BASE_STATE_FILTERS = ['open', 'all'];
+/** Filters a tracker may add past the base ones: the six neutral categories, then its own ids. */
+export const TRACKER_STATE_FILTERS_MAX = 16;
+/**
+ * The shape of an item's identifier, which OpenChamber compares
+ * case-insensitively everywhere (links, tracked items, session links):
+ * `key-number` is `PROJ-42` (Jira, YouTrack, Linear), `number` a bare number
+ * (Azure DevOps, Redmine), `short-code` letters and digits (Trello, ClickUp).
+ */
+export const TRACKER_IDENTIFIER_KINDS = ['key-number', 'number', 'short-code'];
+export const toPublicTracker = (contribution) => {
+    const view = {
+        label: contribution.label,
+        instances: { ...contribution.instances },
+        // Browser sign-in first where both exist: it needs no token to be made by hand.
+        authMethods: [
+            ...(contribution.auth.oauth ? ['oauth'] : []),
+            ...(contribution.auth.token ? ['token'] : []),
+        ],
+    };
+    if (contribution.auth.token) {
+        view.token = {
+            scheme: contribution.auth.token.scheme,
+            username: contribution.auth.token.username === true,
+            scopes: [...(contribution.auth.token.scopes ?? [])],
+        };
+        if (contribution.auth.token.createPath)
+            view.token.createPath = contribution.auth.token.createPath;
+    }
+    if (contribution.auth.oauth)
+        view.oauth = { scopes: [...(contribution.auth.oauth.scopes ?? [])] };
+    return view;
+};
 /** Default instances a Git host extension may name. */
 export const SOURCE_CONTROL_DEFAULT_INSTANCES_MAX = 4;
 /** URL templates per kind (`presentation.urls.changeRequest` / `.issue`). */
@@ -127,9 +224,11 @@ export const serviceProvides = (service, role) => Boolean(service?.provides?.inc
  * `shells` are declared under `contributes.capabilities`; `service`, `network`,
  * `filesystem` and `origins` follow from `contributes.service`,
  * `contributes.integration`, `contributes.filesystem` and `contributes.origins`. `model` is one-off text generation with the
- * user's Small Model (`host.generate`), outside any session.
+ * user's Small Model (`host.generate`), outside any session. `transcript`
+ * follows from `contributes.sessionEvents.content`: the service receives what
+ * the agent said or asked, not only that it did.
  */
-export const GUEST_CAPABILITIES = ['prompt', 'sessions', 'files', 'model', 'shells', 'conversation', 'service', 'network', 'filesystem', 'origins'];
+export const GUEST_CAPABILITIES = ['prompt', 'sessions', 'files', 'model', 'shells', 'conversation', 'service', 'network', 'filesystem', 'origins', 'transcript'];
 export const DECLARED_GUEST_CAPABILITIES = ['prompt', 'sessions', 'files', 'model', 'shells'];
 /** How many `contributes.origins` a package may declare. */
 export const GUEST_ORIGINS_MAX = 8;
@@ -169,8 +268,15 @@ export const requestedGuestCapabilities = (contributes) => {
         declared.add('filesystem');
     if (contributes.origins && contributes.origins.length > 0)
         declared.add('origins');
+    if (contributes.sessionEvents?.content)
+        declared.add('transcript');
     return GUEST_CAPABILITIES.filter((capability) => declared.has(capability));
 };
+/** What the catalog and the approval dialog show of `contributes.sessionEvents`. */
+export const toPublicSessionEvents = (contribution) => ({
+    events: [...contribution.events],
+    content: contribution.content === true,
+});
 /**
  * Whether the package ships a visible panel. Background-only extensions can
  * execute code but have no rail surface, attach picker, or full-screen page.