@openchamber/sdk 2.5.3 → 2.6.0

package/dist/parse.d.ts

@@ -118,7 +118,9 @@ export declare const openChamberManifestSchema: z.ZodObject<{
             }>>>;
             provides: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                 browser: "browser";
+                notifications: "notifications";
                 "source-control": "source-control";
+                tracker: "tracker";
             }>>>;
             surface: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strip>>;
@@ -284,6 +286,97 @@ export declare const openChamberManifestSchema: z.ZodObject<{
                 changeRequestTemplates: z.ZodArray<z.ZodString>;
             }, z.core.$strict>;
         }, z.core.$strict>>;
+        sessionEvents: z.ZodOptional<z.ZodObject<{
+            events: z.ZodArray<z.ZodEnum<{
+                "permission-asked": "permission-asked";
+                "question-asked": "question-asked";
+                "turn-failed": "turn-failed";
+                "turn-finished": "turn-finished";
+            }>>;
+            content: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strict>>;
+        notifications: z.ZodOptional<z.ZodObject<{
+            label: z.ZodString;
+            instances: z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"fixed">;
+                origin: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"user">;
+                label: z.ZodString;
+                placeholder: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>;
+            token: z.ZodObject<{
+                header: z.ZodEnum<{
+                    authorization: "authorization";
+                    "private-token": "private-token";
+                }>;
+                scheme: z.ZodEnum<{
+                    basic: "basic";
+                    bearer: "bearer";
+                    none: "none";
+                    token: "token";
+                }>;
+                username: z.ZodOptional<z.ZodBoolean>;
+                scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                createPath: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        tracker: z.ZodOptional<z.ZodObject<{
+            wire: z.ZodLiteral<1>;
+            label: z.ZodString;
+            instances: z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"fixed">;
+                origin: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"user">;
+                label: z.ZodString;
+                placeholder: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>;
+            auth: z.ZodObject<{
+                token: z.ZodOptional<z.ZodObject<{
+                    header: z.ZodEnum<{
+                        authorization: "authorization";
+                        "private-token": "private-token";
+                    }>;
+                    scheme: z.ZodEnum<{
+                        basic: "basic";
+                        bearer: "bearer";
+                        none: "none";
+                        token: "token";
+                    }>;
+                    username: z.ZodOptional<z.ZodBoolean>;
+                    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    createPath: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                oauth: z.ZodOptional<z.ZodObject<{
+                    authorizeUrl: z.ZodString;
+                    tokenUrl: z.ZodString;
+                    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            capabilities: z.ZodObject<{
+                multipleAccounts: z.ZodDefault<z.ZodBoolean>;
+                stateUpdate: z.ZodDefault<z.ZodBoolean>;
+                children: z.ZodDefault<z.ZodBoolean>;
+                labels: z.ZodDefault<z.ZodBoolean>;
+                priority: z.ZodDefault<z.ZodBoolean>;
+                filters: z.ZodDefault<z.ZodObject<{
+                    people: z.ZodDefault<z.ZodBoolean>;
+                    priority: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>;
+                projectMapping: z.ZodDefault<z.ZodBoolean>;
+                sessionComments: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>;
+            stateFilters: z.ZodArray<z.ZodString>;
+            identifier: z.ZodEnum<{
+                "key-number": "key-number";
+                number: "number";
+                "short-code": "short-code";
+            }>;
+            urls: z.ZodObject<{
+                item: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const PACKAGE_VERSION_PATTERN: RegExp;
@@ -407,7 +500,9 @@ export declare const packageManifestSchema: z.ZodObject<{
                 }>>>;
                 provides: z.ZodOptional<z.ZodArray<z.ZodEnum<{
                     browser: "browser";
+                    notifications: "notifications";
                     "source-control": "source-control";
+                    tracker: "tracker";
                 }>>>;
                 surface: z.ZodOptional<z.ZodLiteral<true>>;
             }, z.core.$strip>>;
@@ -573,6 +668,97 @@ export declare const packageManifestSchema: z.ZodObject<{
                     changeRequestTemplates: z.ZodArray<z.ZodString>;
                 }, z.core.$strict>;
             }, z.core.$strict>>;
+            sessionEvents: z.ZodOptional<z.ZodObject<{
+                events: z.ZodArray<z.ZodEnum<{
+                    "permission-asked": "permission-asked";
+                    "question-asked": "question-asked";
+                    "turn-failed": "turn-failed";
+                    "turn-finished": "turn-finished";
+                }>>;
+                content: z.ZodOptional<z.ZodLiteral<true>>;
+            }, z.core.$strict>>;
+            notifications: z.ZodOptional<z.ZodObject<{
+                label: z.ZodString;
+                instances: z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"fixed">;
+                    origin: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"user">;
+                    label: z.ZodString;
+                    placeholder: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>;
+                token: z.ZodObject<{
+                    header: z.ZodEnum<{
+                        authorization: "authorization";
+                        "private-token": "private-token";
+                    }>;
+                    scheme: z.ZodEnum<{
+                        basic: "basic";
+                        bearer: "bearer";
+                        none: "none";
+                        token: "token";
+                    }>;
+                    username: z.ZodOptional<z.ZodBoolean>;
+                    scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    createPath: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+            tracker: z.ZodOptional<z.ZodObject<{
+                wire: z.ZodLiteral<1>;
+                label: z.ZodString;
+                instances: z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"fixed">;
+                    origin: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"user">;
+                    label: z.ZodString;
+                    placeholder: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>;
+                auth: z.ZodObject<{
+                    token: z.ZodOptional<z.ZodObject<{
+                        header: z.ZodEnum<{
+                            authorization: "authorization";
+                            "private-token": "private-token";
+                        }>;
+                        scheme: z.ZodEnum<{
+                            basic: "basic";
+                            bearer: "bearer";
+                            none: "none";
+                            token: "token";
+                        }>;
+                        username: z.ZodOptional<z.ZodBoolean>;
+                        scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                        createPath: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>>;
+                    oauth: z.ZodOptional<z.ZodObject<{
+                        authorizeUrl: z.ZodString;
+                        tokenUrl: z.ZodString;
+                        scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>;
+                capabilities: z.ZodObject<{
+                    multipleAccounts: z.ZodDefault<z.ZodBoolean>;
+                    stateUpdate: z.ZodDefault<z.ZodBoolean>;
+                    children: z.ZodDefault<z.ZodBoolean>;
+                    labels: z.ZodDefault<z.ZodBoolean>;
+                    priority: z.ZodDefault<z.ZodBoolean>;
+                    filters: z.ZodDefault<z.ZodObject<{
+                        people: z.ZodDefault<z.ZodBoolean>;
+                        priority: z.ZodDefault<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                    projectMapping: z.ZodDefault<z.ZodBoolean>;
+                    sessionComments: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>;
+                stateFilters: z.ZodArray<z.ZodString>;
+                identifier: z.ZodEnum<{
+                    "key-number": "key-number";
+                    number: "number";
+                    "short-code": "short-code";
+                }>;
+                urls: z.ZodObject<{
+                    item: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
         }, z.core.$strip>;
     }, z.core.$strip>;
 }, z.core.$strip>;

package/dist/parse.js

@@ -1,8 +1,9 @@
 import { z } from 'zod';
 import { OPENCHAMBER_SDK_MANIFEST_API_VERSIONS } from './api-version.js';
 import { OPENCHAMBER_ENGINE_PATTERN } from './host-version.js';
-import { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, 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, PANEL_ID, hasGuestPage, isGuestFilesystemPattern, isGuestPackageSvgIcon, isSafeAssetPath, resolveIntegrationAuth, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, SOURCE_CONTROL_DEFAULT_INSTANCES_MAX, SOURCE_CONTROL_GUEST_ID_MAX, SOURCE_CONTROL_URL_TEMPLATES_MAX, SOURCE_CONTROL_URL_TEMPLATE_MAX, SOURCE_CONTROL_URL_TOKENS, } from './manifest.js';
+import { DECLARED_GUEST_CAPABILITIES, GUEST_ACTIONS_MAX, GUEST_ACTION_LABEL_MAX, GUEST_COMMANDS_MAX, GUEST_COMMAND_DESCRIPTION_MAX, GUEST_COMMAND_NAME, GUEST_FILESYSTEM_PATTERNS_MAX, GUEST_FILESYSTEM_PATTERN_MAX, GUEST_ORIGINS_MAX, GUEST_SERVICE_PROVIDES, 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, PANEL_ID, hasGuestPage, isGuestFilesystemPattern, isGuestPackageSvgIcon, isSafeAssetPath, resolveIntegrationAuth, GUEST_SURFACE_DOCKS, GUEST_SURFACE_DOCK_SIZE_MAX, GUEST_SURFACE_DOCK_SIZE_MIN, GUEST_STATUS_SECTION_HEIGHT_MAX, GUEST_STATUS_SECTION_HEIGHT_MIN, GUEST_STATUS_SECTION_TITLE_MAX, NOTIFICATIONS_GUEST_ID_MAX, SOURCE_CONTROL_DEFAULT_INSTANCES_MAX, SOURCE_CONTROL_GUEST_ID_MAX, SOURCE_CONTROL_URL_TEMPLATES_MAX, SOURCE_CONTROL_URL_TEMPLATE_MAX, SOURCE_CONTROL_URL_TOKENS, TRACKER_BASE_STATE_FILTERS, TRACKER_GUEST_ID_MAX, TRACKER_IDENTIFIER_KINDS, TRACKER_STATE_FILTERS_MAX, TRACKER_URL_TEMPLATES_MAX, TRACKER_URL_TOKENS, isTrackerUrlTemplate, } from './manifest.js';
 import { isGuestRequestPath } from './contract.js';
+import { GUEST_SESSION_EVENT_TYPES } from './session-events.js';
 import { GUEST_STATUS_SOURCE_INTERVAL_MAX, GUEST_STATUS_SOURCE_INTERVAL_MIN } from './status-view.js';
 import { GUEST_FILE_EDITORS_MAX, GUEST_FILE_EDITOR_PATTERNS_MAX, GUEST_FILE_EDITOR_TITLE_MAX, isFileEditorPattern, } from './file-editor.js';
 const isPanelIcon = (value) => (PANEL_ID.test(value) || isGuestPackageSvgIcon(value));
@@ -300,7 +301,88 @@ const sourceControlSchema = z.object({
         });
     });
 });
+// The token block of a notification channel follows the Git host's rules: a
+// bare token travels only as `private-token`, and `basic` needs the login.
+const notificationsTokenSchema = z.object({
+    header: z.enum(['authorization', 'private-token']),
+    scheme: z.enum(['bearer', 'token', 'basic', 'none']),
+    username: z.boolean().optional(),
+    scopes: z.array(z.string().trim().min(1).max(64)).max(32).optional(),
+    createPath: z.string().trim().max(256).refine(isSafeApiPath, { message: 'must be a path on the instance starting with "/", with no "." or ".." segment' }).optional(),
+}).strict().refine((token) => (token.header === 'private-token') === (token.scheme === 'none'), { message: 'private-token takes the bare token; authorization takes a bearer, token or basic scheme' }).refine((token) => (token.scheme === 'basic') === (token.username === true), { message: 'the basic scheme needs username: true, and username is only for the basic scheme' });
+const notificationsSchema = z.object({
+    label: literalSchema,
+    instances: z.union([
+        z.object({
+            kind: z.literal('fixed'),
+            origin: z.string().trim().refine(isHttpsOrigin, { message: 'must be an https origin with no path, like https://slack.com' }),
+        }).strict(),
+        z.object({
+            kind: z.literal('user'),
+            label: literalSchema,
+            placeholder: z.string().trim().max(256).optional(),
+        }).strict(),
+    ]),
+    token: notificationsTokenSchema,
+}).strict();
 const uniqueBy = (items, key) => (new Set(items.map(key)).size === items.length);
+// A state filter id: the neutral categories and a tracker's own (`inReview`).
+const TRACKER_STATE_FILTER = /^[a-z][a-zA-Z0-9-]{0,31}$/;
+const trackerTokenSchema = notificationsTokenSchema;
+// An OAuth endpoint: an https URL, or a path on the instance the user names.
+const trackerOauthEndpointSchema = z.string().trim().min(1).max(2_048).refine((value) => isHttpsUrl(value) || isSafeApiPath(value), { message: 'must be an https URL, or a path on the instance starting with "/"' });
+const trackerSchema = z.object({
+    wire: z.literal(1),
+    label: literalSchema,
+    instances: z.union([
+        z.object({
+            kind: z.literal('fixed'),
+            origin: z.string().trim().refine(isHttpsOrigin, { message: 'must be an https origin with no path, like https://tracker.example.com' }),
+        }).strict(),
+        z.object({
+            kind: z.literal('user'),
+            label: literalSchema,
+            placeholder: z.string().trim().max(256).optional(),
+        }).strict(),
+    ]),
+    auth: z.object({
+        token: trackerTokenSchema.optional(),
+        oauth: z.object({
+            authorizeUrl: trackerOauthEndpointSchema,
+            tokenUrl: trackerOauthEndpointSchema,
+            scopes: z.array(z.string().trim().min(1).max(64)).max(32).optional(),
+        }).strict().optional(),
+    }).strict().refine((auth) => auth.token !== undefined || auth.oauth !== undefined, { message: 'declare token, oauth or both' }),
+    capabilities: z.object({
+        multipleAccounts: z.boolean().default(false),
+        stateUpdate: z.boolean().default(false),
+        children: z.boolean().default(false),
+        labels: z.boolean().default(false),
+        priority: z.boolean().default(false),
+        filters: z.object({ people: z.boolean().default(false), priority: z.boolean().default(false) }).strict().default({ people: false, priority: false }),
+        projectMapping: z.boolean().default(false),
+        sessionComments: z.boolean().default(false),
+    }).strict(),
+    stateFilters: z.array(z.string().trim().regex(TRACKER_STATE_FILTER)).min(TRACKER_BASE_STATE_FILTERS.length).max(TRACKER_STATE_FILTERS_MAX)
+        .refine((filters) => new Set(filters).size === filters.length, { message: 'state filters must be unique' })
+        .refine((filters) => TRACKER_BASE_STATE_FILTERS.every((filter, index) => filters[index] === filter), {
+        message: `state filters start with ${TRACKER_BASE_STATE_FILTERS.map((filter) => `"${filter}"`).join(', ')}`,
+    }),
+    identifier: z.enum(TRACKER_IDENTIFIER_KINDS),
+    urls: z.object({
+        item: z.array(z.string().trim().min(1)).min(1).max(TRACKER_URL_TEMPLATES_MAX)
+            .refine((templates) => new Set(templates).size === templates.length, { message: 'link templates must be unique' }),
+    }).strict(),
+}).strict().superRefine((value, ctx) => {
+    value.urls.item.forEach((template, index) => {
+        if (isTrackerUrlTemplate(template))
+            return;
+        ctx.addIssue({
+            code: 'custom', path: ['urls', 'item', index],
+            message: `templates start with "/" and use literal segments and ${TRACKER_URL_TOKENS.join(', ')}, with {id} once, in the path or as "?name={id}".`,
+        });
+    });
+});
 // `roles` only means something on a message action and `payload` only on a
 // session action; a dead field is a misconfiguration and fails closed.
 const actionSchema = z.object({
@@ -378,6 +460,13 @@ const contributesSchema = z.object({
     tools: toolsSchema.optional(),
     fileEditors: fileEditorsSchema.optional(),
     sourceControl: sourceControlSchema.optional(),
+    sessionEvents: z.object({
+        events: z.array(z.enum(GUEST_SESSION_EVENT_TYPES)).min(1).max(GUEST_SESSION_EVENT_TYPES.length)
+            .refine((events) => new Set(events).size === events.length, { message: 'event types must be unique' }),
+        content: z.literal(true).optional(),
+    }).strict().optional(),
+    notifications: notificationsSchema.optional(),
+    tracker: trackerSchema.optional(),
 });
 /**
  * Contributions that need either the panel or background execution frame.
@@ -396,11 +485,11 @@ const runtimeContributions = (contributes) => {
         declared.push('capabilities');
     if (contributes.integration !== undefined)
         declared.push('integration');
-    // A service the host starts itself (it provides a role or a surface) needs
-    // no frame; one that only answers a panel's `serviceRequest` has no caller
-    // without one.
+    // A service the host starts itself (it provides a role or a surface, or
+    // receives session events) needs no frame; one that only answers a panel's
+    // `serviceRequest` has no caller without one.
     if (contributes.service !== undefined && !contributes.service.provides?.length && !contributes.service.surface
-        && !hasStatusSource(contributes))
+        && !hasStatusSource(contributes) && contributes.sessionEvents === undefined)
         declared.push('service');
     if (contributes.filesystem !== undefined)
         declared.push('filesystem');
@@ -435,6 +524,47 @@ export const openChamberManifestSchema = z.object({
             });
             return;
         }
+        // The notification channel and the role that serves it come together, named `ext-<panel.id>` as well.
+        const providesNotifications = contributes.service?.provides?.includes('notifications') === true;
+        if (providesNotifications !== (contributes.notifications !== undefined)) {
+            ctx.addIssue({
+                code: 'custom', path: ['service', 'provides'],
+                message: 'service.provides "notifications" and contributes.notifications come together: declare both or neither.',
+            });
+            return;
+        }
+        if (providesNotifications && contributes.panel.id.length > NOTIFICATIONS_GUEST_ID_MAX) {
+            ctx.addIssue({
+                code: 'custom', path: ['service', 'provides'],
+                message: `A notifications extension's panel.id is at most ${NOTIFICATIONS_GUEST_ID_MAX} characters: OpenChamber names its channel "ext-<panel.id>".`,
+            });
+            return;
+        }
+        // The tracker and the role that serves it come together, named `ext-<panel.id>` as well.
+        const providesTracker = contributes.service?.provides?.includes('tracker') === true;
+        if (providesTracker !== (contributes.tracker !== undefined)) {
+            ctx.addIssue({
+                code: 'custom', path: ['service', 'provides'],
+                message: 'service.provides "tracker" and contributes.tracker come together: declare both or neither.',
+            });
+            return;
+        }
+        if (providesTracker && contributes.panel.id.length > TRACKER_GUEST_ID_MAX) {
+            ctx.addIssue({
+                code: 'custom', path: ['service', 'provides'],
+                message: `A tracker extension's panel.id is at most ${TRACKER_GUEST_ID_MAX} characters: OpenChamber names its tracker "ext-<panel.id>".`,
+            });
+            return;
+        }
+        // Tracker and Git host ids share one namespace (tracked items, the read
+        // cache, session links), and both would be `ext-<panel.id>`.
+        if (providesTracker && providesSourceControl) {
+            ctx.addIssue({
+                code: 'custom', path: ['service', 'provides'],
+                message: 'An extension is a Git host ("source-control") or a tracker ("tracker"), never both: the two roles would share the id "ext-<panel.id>".',
+            });
+            return;
+        }
         // Docking only means something for a page beside a shared surface.
         const docked = contributes.panel.dock !== undefined || contributes.panel.size !== undefined;
         if (docked && !(contributes.service?.surface && hasGuestPage(contributes))) {
@@ -460,6 +590,14 @@ export const openChamberManifestSchema = z.object({
             });
             return;
         }
+        // Session events are posted to the extension's service; without one there is nothing to post to.
+        if (contributes.sessionEvents !== undefined && !contributes.service) {
+            ctx.addIssue({
+                code: 'custom', path: ['sessionEvents'],
+                message: 'contributes.sessionEvents are posted to the extension\'s service; declare contributes.service.',
+            });
+            return;
+        }
         if (hasGuestPage(contributes))
             return;
         if (contributes.background) {
@@ -606,6 +744,11 @@ const failureFromIssue = (issue) => {
     if (path.startsWith('contributes.fileEditors')) {
         return fail('invalid-file-editors', `contributes.fileEditors lists 1 to ${GUEST_FILE_EDITORS_MAX} editors with a unique kebab-case id, a title of 1 to ${GUEST_FILE_EDITOR_TITLE_MAX} characters, match: 1 to ${GUEST_FILE_EDITOR_PATTERNS_MAX} file-name patterns (no "/", not only wildcards, like "*.excalidraw"), an entry ending in .html inside the package, and optional content "text" or "binary".`);
     }
+    if (path === 'contributes.sessionEvents' || path.startsWith('contributes.sessionEvents.')) {
+        return fail('invalid-session-events', issue.code === 'custom' && path === 'contributes.sessionEvents'
+            ? issue.message
+            : `contributes.sessionEvents is { events: [1 to ${GUEST_SESSION_EVENT_TYPES.length} distinct of ${GUEST_SESSION_EVENT_TYPES.map((type) => `"${type}"`).join(', ')}], content?: true }.`);
+    }
     if (path.startsWith('contributes.integration')) {
         return fail('invalid-integration', 'contributes.integration needs a name, description, and oauth, token, or host.');
     }
@@ -616,10 +759,22 @@ const failureFromIssue = (issue) => {
             ? `${field}: ${issue.message}`
             : `${field} is invalid: see "contributes.sourceControl" in GUEST_SERVICES.md for every field.`);
     }
+    if (path.startsWith('contributes.notifications')) {
+        const field = fieldPath(issue.path);
+        return fail('invalid-service', issue.code === 'custom'
+            ? `${field}: ${issue.message}`
+            : `${field} is invalid: see "contributes.notifications" in GUEST_SERVICES.md for every field.`);
+    }
+    if (path.startsWith('contributes.tracker')) {
+        const field = fieldPath(issue.path);
+        return fail('invalid-service', issue.code === 'custom'
+            ? `${field}: ${issue.message}`
+            : `${field} is invalid: see "contributes.tracker" in GUEST_SERVICES.md for every field.`);
+    }
     if (path.startsWith('contributes.service')) {
         return fail('invalid-service', issue.code === 'custom'
             ? issue.message
-            : 'contributes.service needs entry, runtime "host", optional permissions, optional provides ("browser", "source-control"), and optional surface (true).');
+            : 'contributes.service needs entry, runtime "host", optional permissions, optional provides ("browser", "source-control", "notifications", "tracker"), and optional surface (true).');
     }
     return fail('missing-panel', 'contributes.panel is required.');
 };

package/dist/protocol.d.ts

@@ -58,6 +58,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
                 title: z.ZodString;
                 projectId: z.ZodString;
                 directory: z.ZodString;
+                agent: z.ZodOptional<z.ZodString>;
                 parentId: z.ZodNullable<z.ZodString>;
                 createdAt: z.ZodNumber;
                 updatedAt: z.ZodNumber;
@@ -481,6 +482,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
             title: z.ZodString;
             projectId: z.ZodString;
             directory: z.ZodString;
+            agent: z.ZodOptional<z.ZodString>;
             parentId: z.ZodNullable<z.ZodString>;
             createdAt: z.ZodNumber;
             updatedAt: z.ZodNumber;
@@ -647,6 +649,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
             title: string;
             projectId: string;
             directory: string;
+            agent?: string | undefined;
             parentId: string | null;
             createdAt: number;
             updatedAt: number;
@@ -796,6 +799,7 @@ export declare const hostMessageSchema: z.ZodUnion<readonly [z.ZodObject<{
             title: string;
             projectId: string;
             directory: string;
+            agent?: string | undefined;
             parentId: string | null;
             createdAt: number;
             updatedAt: number;

package/dist/schemas.d.ts

@@ -5,6 +5,6 @@ export { guestStatusControlsSchema, guestStatusControlEventSchema } from './stat
 export { guestStatusViewSchema } from './status-view-schemas.ts';
 export { guestPopoverClosedEventSchema, guestPopoverRequestSchema } from './popover-schemas.ts';
 export { guestMessageSchema, hostMessageSchema, parseGuestMessage, parseHostMessage, } from './protocol.ts';
-export { browserControlActionSchema, browserProviderResultSchema, sourceControlProviderMethodSchema, sourceControlProviderSchemasV1, } from './service-provider-schemas.ts';
+export { browserControlActionSchema, browserProviderResultSchema, notificationsProviderMethodSchema, notificationsProviderSchemasV1, sessionEventResultSchema, sourceControlProviderMethodSchema, sourceControlProviderSchemasV1, trackerProviderMethodSchema, trackerProviderSchemasV1, } from './service-provider-schemas.ts';
 export { surfaceClipboardAnswerSchema, surfaceControllerSchema, surfaceHostMessageSchema, surfaceInputEventSchema, surfaceResizeAnswerSchema, surfaceViewerMessageSchema, } from './service-surface-schemas.ts';
 export type { SurfaceHostMessage, SurfaceViewerMessage } from './service-surface-schemas.ts';

package/dist/schemas.js

@@ -7,5 +7,5 @@ export { guestStatusControlsSchema, guestStatusControlEventSchema } from './stat
 export { guestStatusViewSchema } from './status-view-schemas.js';
 export { guestPopoverClosedEventSchema, guestPopoverRequestSchema } from './popover-schemas.js';
 export { guestMessageSchema, hostMessageSchema, parseGuestMessage, parseHostMessage, } from './protocol.js';
-export { browserControlActionSchema, browserProviderResultSchema, sourceControlProviderMethodSchema, sourceControlProviderSchemasV1, } from './service-provider-schemas.js';
+export { browserControlActionSchema, browserProviderResultSchema, notificationsProviderMethodSchema, notificationsProviderSchemasV1, sessionEventResultSchema, sourceControlProviderMethodSchema, sourceControlProviderSchemasV1, trackerProviderMethodSchema, trackerProviderSchemasV1, } from './service-provider-schemas.js';
 export { surfaceClipboardAnswerSchema, surfaceControllerSchema, surfaceHostMessageSchema, surfaceInputEventSchema, surfaceResizeAnswerSchema, surfaceViewerMessageSchema, } from './service-surface-schemas.js';