@canhta/dsh-autopilot 0.1.0-alpha.1

package/lib/mcp/definition.js

@@ -0,0 +1,43 @@
+/** Require a zero-argument object input before binding an MCP identity operation. */
+export function hasNoArgumentObjectInput(definition) {
+    const properties = definition.parameters.properties;
+    const required = definition.parameters.required;
+    return (definition.parameters.type === 'object' &&
+        isRecord(properties) &&
+        (required === undefined || (Array.isArray(required) && required.length === 0)));
+}
+/** Check the top-level shape used by a pinned MCP operation contract. */
+export function hasInputShape(definition, requiredNames, propertyTypes) {
+    const required = definition.parameters.required;
+    return (definition.parameters.type === 'object' &&
+        Array.isArray(required) &&
+        requiredNames.every((name) => required.includes(name)) &&
+        isRecord(definition.parameters.properties) &&
+        Object.entries(propertyTypes).every(([name, type]) => property(definition, name)?.type === type));
+}
+export function propertyEnumIncludes(definition, name, value) {
+    const values = property(definition, name)?.enum;
+    return Array.isArray(values) && values.includes(value);
+}
+export function arrayItemsAreStrings(definition, name) {
+    return arrayItems(definition, name)?.type === 'string';
+}
+export function arrayItemEnumIncludes(definition, name, value) {
+    const values = arrayItems(definition, name)?.enum;
+    return Array.isArray(values) && values.includes(value);
+}
+function arrayItems(definition, name) {
+    const items = property(definition, name)?.items;
+    return isRecord(items) ? items : undefined;
+}
+function property(definition, name) {
+    const properties = definition.parameters.properties;
+    if (!isRecord(properties))
+        return undefined;
+    const value = properties[name];
+    return isRecord(value) ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=definition.js.map

package/lib/mcp/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/mcp/definition.ts"],"names":[],"mappings":"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"}

package/lib/mcp/index.d.ts

@@ -0,0 +1,6 @@
+export { defineMcpContracts, exactMcpToolName, type McpContract, type McpContractInput, type McpContractMap, type McpContractOutput, type McpResult, } from './contracts.js';
+export { createMcpTraversalCursorCodec, type McpTraversalCursor } from './cursor.js';
+export { arrayItemEnumIncludes, arrayItemsAreStrings, hasInputShape, hasNoArgumentObjectInput, propertyEnumIncludes, } from './definition.js';
+export { decodeMcpJson } from './json.js';
+export { type McpTrackerMountOptions, mountMcpTracker } from './mount.js';
+export { type McpErrorFactory, McpOperationError, type McpOperationErrorCode, type McpTools, type ResolvedMcpTools, resolveMcpTools, } from './read-tools.js';

package/lib/mcp/index.js

@@ -0,0 +1,7 @@
+export { defineMcpContracts, exactMcpToolName, } from './contracts.js';
+export { createMcpTraversalCursorCodec } from './cursor.js';
+export { arrayItemEnumIncludes, arrayItemsAreStrings, hasInputShape, hasNoArgumentObjectInput, propertyEnumIncludes, } from './definition.js';
+export { decodeMcpJson } from './json.js';
+export { mountMcpTracker } from './mount.js';
+export { McpOperationError, resolveMcpTools, } from './read-tools.js';
+//# sourceMappingURL=index.js.map

package/lib/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAMjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,6BAA6B,EAA2B,MAAM,aAAa,CAAA;AACpF,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAA+B,eAAe,EAAE,MAAM,YAAY,CAAA;AACzE,OAAO,EAEL,iBAAiB,EAIjB,eAAe,GAChB,MAAM,iBAAiB,CAAA"}

package/lib/mcp/json.d.ts

@@ -0,0 +1,4 @@
+import type { z } from 'zod';
+import type { McpResult } from './contracts.js';
+/** Decode one machine-readable MCP result without treating prose or mixed content as data. */
+export declare function decodeMcpJson<T>(result: McpResult, schema: z.ZodType<T>): T;

package/lib/mcp/json.js

@@ -0,0 +1,20 @@
+/** Decode one machine-readable MCP result without treating prose or mixed content as data. */
+export function decodeMcpJson(result, schema) {
+    const candidate = result.structuredContent ?? parseSingleJsonText(result.content);
+    return schema.parse(candidate);
+}
+function parseSingleJsonText(content) {
+    if (content.length !== 1)
+        throw new TypeError('expected one MCP JSON text block');
+    const [block] = content;
+    if (typeof block !== 'object' ||
+        block === null ||
+        !Object.hasOwn(block, 'type') ||
+        !Object.hasOwn(block, 'text') ||
+        block.type !== 'text' ||
+        typeof block.text !== 'string') {
+        throw new TypeError('expected one MCP JSON text block');
+    }
+    return JSON.parse(block.text);
+}
+//# sourceMappingURL=json.js.map

package/lib/mcp/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/mcp/json.ts"],"names":[],"mappings":"AAGA,8FAA8F;AAC9F,MAAM,UAAU,aAAa,CAAI,MAAiB,EAAE,MAAoB;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,iBAAiB,IAAI,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjF,OAAO,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAChC,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA2B;IACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAA;IACjF,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAA;IACvB,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;QAC7B,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;QAC5B,KAA4B,CAAC,IAAI,KAAK,MAAM;QAC7C,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ,EACtD,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAE,KAA0B,CAAC,IAAI,CAAY,CAAA;AAChE,CAAC"}

package/lib/mcp/mount.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { SettingsScope } from '@deepseek-ai/dsh-settings';
+import type { TrackerProvider } from '../tracker.js';
+import type { McpContractMap } from './contracts.js';
+import { type McpTools } from './read-tools.js';
+interface RequiredMcpToolset<Contracts extends McpContractMap> {
+    readonly serverName: string;
+    readonly contracts: Contracts;
+}
+export interface McpTrackerMountOptions<Settings, Contracts extends McpContractMap> {
+    readonly settings: SettingsScope<Settings>;
+    requiredToolset(settings: Readonly<Settings>): RequiredMcpToolset<Contracts>;
+    createProvider(settings: Readonly<Settings>, tools: McpTools<Contracts>): TrackerProvider;
+}
+/** Keep one tracker generation registered exactly while its Settings snapshot and required MCP tools remain current. */
+export declare function mountMcpTracker<Settings, Contracts extends McpContractMap>(ctx: Context, options: McpTrackerMountOptions<Settings, Contracts>): Promise<() => Promise<void>>;
+export {};

package/lib/mcp/mount.js

@@ -0,0 +1,79 @@
+import { isDeepStrictEqual } from 'node:util';
+import { TrackerProviderError } from '../tracker.js';
+import { resolveMcpTools } from './read-tools.js';
+/** Keep one tracker generation registered exactly while its Settings snapshot and required MCP tools remain current. */
+export async function mountMcpTracker(ctx, options) {
+    let active;
+    let revision = 0;
+    let stopped = false;
+    let queue = Promise.resolve();
+    const reconcile = async (requestedRevision) => {
+        if (stopped)
+            return;
+        let settings;
+        let required;
+        let resolved;
+        try {
+            settings = structuredClone(options.settings.get());
+            required = options.requiredToolset(settings);
+            resolved = resolveMcpTools(ctx, required.serverName, required.contracts, (code, message) => new TrackerProviderError(code, message));
+        }
+        catch {
+            await withdraw();
+            ctx.logger.warn('autopilot MCP tracker configuration is invalid; provider remains unavailable');
+            return;
+        }
+        if (resolved !== undefined &&
+            active !== undefined &&
+            isDeepStrictEqual(active.settings, settings) &&
+            active.resolved.sameDefinitions(resolved)) {
+            return;
+        }
+        await withdraw();
+        if (stopped || requestedRevision !== revision || resolved === undefined || !resolved.isCurrent())
+            return;
+        try {
+            const provider = options.createProvider(settings, resolved.tools);
+            const disposeProvider = ctx.tracker.register(provider);
+            if (stopped || requestedRevision !== revision || !resolved.isCurrent()) {
+                await disposeProvider();
+                return;
+            }
+            active = { settings, resolved, disposeProvider };
+        }
+        catch {
+            ctx.logger.warn('autopilot MCP tracker provider could not be activated');
+        }
+    };
+    const withdraw = async () => {
+        const current = active;
+        active = undefined;
+        if (current !== undefined)
+            await current.disposeProvider();
+    };
+    const schedule = () => {
+        const requestedRevision = ++revision;
+        queue = queue
+            .then(() => reconcile(requestedRevision))
+            .catch(() => {
+            ctx.logger.warn('autopilot MCP tracker reconciliation failed; provider remains unavailable');
+        });
+        return queue;
+    };
+    const stopSettingsWatch = options.settings.watch(() => schedule());
+    const stopToolsWatch = ctx.on('tools/change', () => {
+        void schedule();
+    });
+    await schedule();
+    return async () => {
+        if (stopped)
+            return;
+        stopped = true;
+        revision += 1;
+        stopSettingsWatch();
+        stopToolsWatch();
+        await queue;
+        await withdraw();
+    };
+}
+//# sourceMappingURL=mount.js.map

package/lib/mcp/mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../../src/mcp/mount.ts"],"names":[],"mappings":"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"}

package/lib/mcp/read-tools.d.ts

@@ -0,0 +1,27 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
+import { type McpContractInput, type McpContractMap, type McpContractOutput } from './contracts.js';
+interface BoundContract {
+    readonly definition: ToolDefinition;
+    readonly publicName: string;
+}
+declare const boundDefinitions: unique symbol;
+/** A generation-fenced view that exposes only the provider's declared semantic operations. */
+export interface McpTools<Contracts extends McpContractMap> {
+    call<Operation extends keyof Contracts>(operation: Operation, input: McpContractInput<Contracts[Operation]>, signal: AbortSignal): Promise<McpContractOutput<Contracts[Operation]>>;
+}
+export interface ResolvedMcpTools<Contracts extends McpContractMap> {
+    readonly tools: McpTools<Contracts>;
+    readonly [boundDefinitions]: ReadonlyMap<keyof Contracts, BoundContract>;
+    isCurrent(): boolean;
+    sameDefinitions(other: ResolvedMcpTools<Contracts>): boolean;
+}
+export type McpOperationErrorCode = 'authentication' | 'permission' | 'invalid-configuration' | 'invalid-response' | 'not-found' | 'conflict' | 'rate-limit' | 'timeout' | 'transient' | 'provider-unavailable';
+export declare class McpOperationError extends Error {
+    readonly code: McpOperationErrorCode;
+    constructor(code: McpOperationErrorCode, message: string);
+}
+export type McpErrorFactory = (code: McpOperationErrorCode, message: string) => Error;
+/** Bind compatible live DSH tool definitions, or return undefined while the required MCP generation is unavailable. */
+export declare function resolveMcpTools<Contracts extends McpContractMap>(ctx: Context, serverName: string, contracts: Contracts, createError?: McpErrorFactory): ResolvedMcpTools<Contracts> | undefined;
+export {};

package/lib/mcp/read-tools.js

@@ -0,0 +1,149 @@
+import { ToolCallId } from '@deepseek-ai/dsh-llm';
+import { z } from 'zod';
+import { exactMcpToolName, } from './contracts.js';
+const mcpResultSchema = z
+    .object({
+    content: z.array(z.unknown()),
+    structuredContent: z.unknown().optional(),
+})
+    .strict();
+const boundDefinitions = Symbol('autopilot.mcp.bound-definitions');
+export class McpOperationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'McpOperationError';
+    }
+}
+/** Bind compatible live DSH tool definitions, or return undefined while the required MCP generation is unavailable. */
+export function resolveMcpTools(ctx, serverName, contracts, createError = (code, message) => new McpOperationError(code, message)) {
+    const bound = new Map();
+    try {
+        for (const operation of Object.keys(contracts)) {
+            const contract = contracts[operation];
+            if (contract === undefined)
+                return undefined;
+            const publicName = exactMcpToolName(serverName, contract.rawName);
+            const definition = ctx.tools.get(publicName);
+            if (definition === undefined || !acceptsDefinition(contract, definition))
+                return undefined;
+            bound.set(operation, { definition, publicName });
+        }
+    }
+    catch {
+        return undefined;
+    }
+    const isCurrent = () => {
+        for (const entry of bound.values()) {
+            if (ctx.tools.get(entry.publicName) !== entry.definition)
+                return false;
+        }
+        return true;
+    };
+    const tools = {
+        async call(operation, input, signal) {
+            signal.throwIfAborted();
+            const contract = contracts[operation];
+            const entry = bound.get(operation);
+            if (contract === undefined || entry === undefined) {
+                throw createError('invalid-configuration', 'MCP operation is not declared');
+            }
+            if (ctx.tools.get(entry.publicName) !== entry.definition)
+                throw unavailable(createError);
+            let args;
+            try {
+                args = contract.encode(input);
+            }
+            catch {
+                throw createError('invalid-configuration', 'MCP operation input is invalid');
+            }
+            const result = await ctx.tools.execute({
+                callId: ToolCallId(`autopilot-${crypto.randomUUID()}`),
+                name: entry.publicName,
+                arguments: args,
+                signal,
+            });
+            signal.throwIfAborted();
+            if (ctx.tools.get(entry.publicName) !== entry.definition)
+                throw unavailable(createError);
+            if (result.isError)
+                throw mapToolFailure(createError, result.error.info?.code);
+            const parsed = parseMcpResult(result.value, contract.maxResultBytes, createError);
+            try {
+                return contract.decode(parsed);
+            }
+            catch {
+                throw createError('invalid-response', 'MCP result did not match its contract');
+            }
+        },
+    };
+    return {
+        tools,
+        [boundDefinitions]: bound,
+        isCurrent,
+        sameDefinitions(other) {
+            for (const [operation, entry] of bound) {
+                if (other[boundDefinitions].get(operation)?.definition !== entry.definition)
+                    return false;
+            }
+            return other[boundDefinitions].size === bound.size;
+        },
+    };
+}
+function acceptsDefinition(contract, definition) {
+    try {
+        return contract.acceptsDefinition(definition);
+    }
+    catch {
+        return false;
+    }
+}
+function parseMcpResult(value, maxResultBytes, createError) {
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch {
+        throw createError('invalid-response', 'MCP returned an invalid result');
+    }
+    if (serialized === undefined || Buffer.byteLength(serialized) > maxResultBytes) {
+        throw createError('invalid-response', 'MCP result exceeded its safety bound');
+    }
+    const parsed = mcpResultSchema.safeParse(value);
+    if (!parsed.success)
+        throw createError('invalid-response', 'MCP returned an invalid result');
+    return parsed.data;
+}
+function mapToolFailure(createError, code) {
+    switch (code) {
+        case 'UNKNOWN_TOOL':
+            return unavailable(createError);
+        case 'TOOL_TIMEOUT':
+            return createError('timeout', 'MCP operation timed out');
+        case 'UNAUTHENTICATED':
+        case 'UNAUTHORIZED':
+            return createError('authentication', 'MCP authentication failed');
+        case 'FORBIDDEN':
+        case 'PERMISSION_DENIED':
+            return createError('permission', 'MCP operation was denied');
+        case 'NOT_FOUND':
+            return createError('not-found', 'MCP resource was not found');
+        case 'CONFLICT':
+            return createError('conflict', 'MCP resource changed concurrently');
+        case 'RATE_LIMIT':
+        case 'RESOURCE_EXHAUSTED':
+        case 'TOO_MANY_REQUESTS':
+            return createError('rate-limit', 'MCP provider rate limit was reached');
+        case 'INVALID_ARGS':
+            return createError('invalid-configuration', 'MCP operation input was rejected');
+        case 'INVALID_TOOL_OUTPUT':
+            return createError('invalid-response', 'MCP returned an invalid result');
+        default:
+            return createError('transient', 'MCP operation failed');
+    }
+}
+function unavailable(createError) {
+    return createError('provider-unavailable', 'MCP tool generation is unavailable');
+}
+//# sourceMappingURL=read-tools.js.map

package/lib/mcp/read-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tools.js","sourceRoot":"","sources":["../../src/mcp/read-tools.ts"],"names":[],"mappings":"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"}

package/lib/notification/index.d.ts

@@ -0,0 +1,2 @@
+export * from './model.js';
+export { default, Notifications } from './registry.js';

package/lib/notification/index.js

@@ -0,0 +1,3 @@
+export * from './model.js';
+export { default, Notifications } from './registry.js';
+//# sourceMappingURL=index.js.map

package/lib/notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notification/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA"}

package/lib/notification/model.d.ts

@@ -0,0 +1,57 @@
+declare const notificationProviderIdBrand: unique symbol;
+declare const notificationDestinationIdBrand: unique symbol;
+export type NotificationProviderId = string & {
+    readonly [notificationProviderIdBrand]: true;
+};
+export type NotificationDestinationId = string & {
+    readonly [notificationDestinationIdBrand]: true;
+};
+export declare const notificationProviderId: (value: string) => NotificationProviderId;
+export declare const notificationDestinationId: (value: string) => NotificationDestinationId;
+export declare const NOTIFICATION_INTERFACE_VERSION: 1;
+export interface NotificationEvent {
+    readonly version: 1;
+    readonly eventId: string;
+    readonly runId: string;
+    readonly timestamp: string;
+    readonly type: 'started' | 'blocked' | 'paused' | 'failed' | 'completed';
+    readonly issueIdentity: string;
+    readonly displayKey: string;
+    readonly summary: string;
+    readonly actionNeeded?: string | undefined;
+    readonly runUrl: string;
+    readonly issueUrl: string;
+    readonly pullRequestUrl?: string | undefined;
+    readonly usage: {
+        readonly kind: 'provider' | 'estimate' | 'unknown';
+        readonly tokens?: number | undefined;
+    };
+}
+export interface NotificationReceipt {
+    readonly receiptId: string;
+    readonly receivedAt: string;
+}
+export interface NotificationProviderRequest {
+    readonly destinationId: NotificationDestinationId;
+    readonly event: NotificationEvent;
+    readonly signal: AbortSignal;
+}
+export interface NotificationProvider {
+    readonly id: NotificationProviderId;
+    readonly interfaceVersion: typeof NOTIFICATION_INTERFACE_VERSION;
+    readonly displayName: string;
+    readonly configurationNamespace: string;
+    reconcile(request: NotificationProviderRequest): Promise<NotificationReceipt | undefined>;
+    deliver(request: NotificationProviderRequest): Promise<NotificationReceipt>;
+}
+export interface NotificationSender {
+    reconcile(destinationId: NotificationDestinationId, event: NotificationEvent, signal?: AbortSignal): Promise<NotificationReceipt | undefined>;
+    deliver(destinationId: NotificationDestinationId, event: NotificationEvent, signal?: AbortSignal): Promise<NotificationReceipt>;
+}
+export type NotificationProviderErrorCode = 'authentication' | 'permission' | 'invalid-configuration' | 'permanent-rejection' | 'rate-limit' | 'timeout' | 'transient' | 'ambiguous-acknowledgement' | 'invalid-response' | 'provider-unavailable';
+export declare class NotificationProviderError extends Error {
+    readonly code: NotificationProviderErrorCode;
+    readonly retryAfterMs?: number | undefined;
+    constructor(code: NotificationProviderErrorCode, message: string, retryAfterMs?: number | undefined);
+}
+export {};

package/lib/notification/model.js

@@ -0,0 +1,20 @@
+const ID_PATTERN = /^[a-z0-9][a-z0-9._:-]{0,255}$/;
+function opaqueId(kind, value) {
+    if (!ID_PATTERN.test(value))
+        throw new TypeError(`${kind} must match ${String(ID_PATTERN)}`);
+    return value;
+}
+export const notificationProviderId = (value) => opaqueId('notification provider id', value);
+export const notificationDestinationId = (value) => opaqueId('notification destination id', value);
+export const NOTIFICATION_INTERFACE_VERSION = 1;
+export class NotificationProviderError extends Error {
+    code;
+    retryAfterMs;
+    constructor(code, message, retryAfterMs) {
+        super(message);
+        this.code = code;
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'NotificationProviderError';
+    }
+}
+//# sourceMappingURL=model.js.map

package/lib/notification/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/notification/model.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,GAAG,+BAA+B,CAAA;AAElD,SAAS,QAAQ,CAAmB,IAAY,EAAE,KAAa;IAC7D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,eAAe,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IAC5F,OAAO,KAAU,CAAA;AACnB,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAA0B,EAAE,CAC9E,QAAQ,CAAyB,0BAA0B,EAAE,KAAK,CAAC,CAAA;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAA6B,EAAE,CACpF,QAAQ,CAA4B,6BAA6B,EAAE,KAAK,CAAC,CAAA;AAE3E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAA;AA+DxD,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAEvC,IAAI;IAEJ,YAAY;IAHvB,YACW,IAAmC,EAC5C,OAAe,EACN,YAAqB;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAA;oBAJL,IAAI;4BAEJ,YAAY;QAGrB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAA;IACzC,CAAC;CACF"}

package/lib/notification/registry.d.ts

@@ -0,0 +1,16 @@
+import { type Context, Service } from '@deepseek-ai/cordis';
+import { type NotificationProvider, type NotificationProviderId, type NotificationSender } from './model.js';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        notifications: Notifications;
+    }
+}
+/** Registry for independently loaded notification transports; it stores no destinations, secrets, or delivery state. */
+export declare class Notifications extends Service {
+    private readonly providers;
+    constructor(ctx: Context);
+    register(provider: NotificationProvider): () => Promise<void>;
+    withProvider<T>(id: NotificationProviderId, operation: (sender: NotificationSender) => Promise<T>): Promise<T>;
+    private invoke;
+}
+export default Notifications;

package/lib/notification/registry.js

@@ -0,0 +1,67 @@
+import { Service } from '@deepseek-ai/cordis';
+import { z } from 'zod';
+import { GenerationRegistry } from '../providers/generation-registry.js';
+import { NOTIFICATION_INTERFACE_VERSION, NotificationProviderError, } from './model.js';
+const receiptSchema = z.object({
+    receiptId: z.string().min(1).max(512),
+    receivedAt: z.iso.datetime({ offset: true }),
+});
+/** Registry for independently loaded notification transports; it stores no destinations, secrets, or delivery state. */
+export class Notifications extends Service {
+    providers = new GenerationRegistry();
+    constructor(ctx) {
+        super(ctx, 'notifications');
+    }
+    register(provider) {
+        if (provider.interfaceVersion !== NOTIFICATION_INTERFACE_VERSION) {
+            throw new TypeError(`notification provider "${provider.id}" uses interface version ${String(provider.interfaceVersion)}; expected ${String(NOTIFICATION_INTERFACE_VERSION)}`);
+        }
+        if (this.providers.has(provider.id))
+            throw new Error(`notification provider "${provider.id}" is already registered`);
+        return this.providers.register(provider.id, provider);
+    }
+    async withProvider(id, operation) {
+        const registered = this.providers.require(id, () => new NotificationProviderError('provider-unavailable', `notification provider "${id}" is unavailable`));
+        const sender = {
+            reconcile: (destinationId, event, signal) => this.invoke(registered, 'reconcile', destinationId, event, signal),
+            deliver: async (destinationId, event, signal) => {
+                const receipt = await this.invoke(registered, 'deliver', destinationId, event, signal);
+                if (receipt === undefined) {
+                    throw new NotificationProviderError('invalid-response', 'notification provider omitted its delivery receipt');
+                }
+                return receipt;
+            },
+        };
+        return await this.providers.retain(registered, () => operation(sender));
+    }
+    async invoke(registered, operation, destinationId, event, callerSignal) {
+        callerSignal?.throwIfAborted();
+        const request = {
+            destinationId,
+            event: structuredClone(event),
+            signal: this.providers.signal(registered, callerSignal),
+        };
+        try {
+            const result = await registered.provider[operation](request);
+            this.providers.assertCurrent(registered, () => withdrawn(registered.provider.id, operation));
+            callerSignal?.throwIfAborted();
+            return result === undefined ? undefined : receiptSchema.parse(result);
+        }
+        catch (error) {
+            if (!registered.accepting)
+                throw withdrawn(registered.provider.id, operation);
+            callerSignal?.throwIfAborted();
+            if (error instanceof NotificationProviderError)
+                throw error;
+            if (error instanceof z.ZodError) {
+                throw new NotificationProviderError('invalid-response', 'notification provider returned an invalid receipt');
+            }
+            throw new NotificationProviderError('transient', 'notification provider delivery failed');
+        }
+    }
+}
+function withdrawn(id, operation) {
+    return new NotificationProviderError(operation === 'deliver' ? 'ambiguous-acknowledgement' : 'provider-unavailable', `notification provider "${id}" was withdrawn`);
+}
+export default Notifications;
+//# sourceMappingURL=registry.js.map

package/lib/notification/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/notification/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,kBAAkB,EAA2B,MAAM,qCAAqC,CAAA;AACjG,OAAO,EACL,8BAA8B,EAI9B,yBAAyB,GAK1B,MAAM,YAAY,CAAA;AAEnB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;CAC7C,CAAC,CAAA;AAQF,wHAAwH;AACxH,MAAM,OAAO,aAAc,SAAQ,OAAO;IACvB,SAAS,GAAG,IAAI,kBAAkB,EAAgD,CAAA;IAEnG,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC,CAAA;IAC7B,CAAC;IAED,QAAQ,CAAC,QAA8B;QACrC,IAAI,QAAQ,CAAC,gBAAgB,KAAK,8BAA8B,EAAE,CAAC;YACjE,MAAM,IAAI,SAAS,CACjB,0BAA0B,QAAQ,CAAC,EAAE,4BAA4B,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,cAAc,MAAM,CAAC,8BAA8B,CAAC,EAAE,CACzJ,CAAA;QACH,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,EAAE,yBAAyB,CAAC,CAAA;QACpH,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,YAAY,CAAI,EAA0B,EAAE,SAAqD;QACrG,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CACvC,EAAE,EACF,GAAG,EAAE,CAAC,IAAI,yBAAyB,CAAC,sBAAsB,EAAE,0BAA0B,EAAE,kBAAkB,CAAC,CAC5G,CAAA;QACD,MAAM,MAAM,GAAuB;YACjC,SAAS,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC;YAC/G,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC9C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;gBACtF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,MAAM,IAAI,yBAAyB,CAAC,kBAAkB,EAAE,oDAAoD,CAAC,CAAA;gBAC/G,CAAC;gBACD,OAAO,OAAO,CAAA;YAChB,CAAC;SACF,CAAA;QACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACzE,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,UAAoD,EACpD,SAAkC,EAClC,aAAwC,EACxC,KAAwB,EACxB,YAA0B;QAE1B,YAAY,EAAE,cAAc,EAAE,CAAA;QAC9B,MAAM,OAAO,GAAgC;YAC3C,aAAa;YACb,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC;SACxD,CAAA;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAA;YAC5D,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAA;YAC5F,YAAY,EAAE,cAAc,EAAE,CAAA;YAC9B,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,SAAS;gBAAE,MAAM,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAA;YAC7E,YAAY,EAAE,cAAc,EAAE,CAAA;YAC9B,IAAI,KAAK,YAAY,yBAAyB;gBAAE,MAAM,KAAK,CAAA;YAC3D,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,yBAAyB,CAAC,kBAAkB,EAAE,mDAAmD,CAAC,CAAA;YAC9G,CAAC;YACD,MAAM,IAAI,yBAAyB,CAAC,WAAW,EAAE,uCAAuC,CAAC,CAAA;QAC3F,CAAC;IACH,CAAC;CACF;AAED,SAAS,SAAS,CAAC,EAA0B,EAAE,SAAkC;IAC/E,OAAO,IAAI,yBAAyB,CAClC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,sBAAsB,EAC9E,0BAA0B,EAAE,iBAAiB,CAC9C,CAAA;AACH,CAAC;AAED,eAAe,aAAa,CAAA"}

package/lib/notification.d.ts

@@ -0,0 +1,2 @@
+export * from './notification/index.js';
+export { default } from './notification/index.js';

package/lib/notification.js

@@ -0,0 +1,3 @@
+export * from './notification/index.js';
+export { default } from './notification/index.js';
+//# sourceMappingURL=notification.js.map

package/lib/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../src/notification.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA"}

package/lib/ntfy-notification.d.ts

@@ -0,0 +1 @@
+export * from './providers/ntfy-notification/index.js';

package/lib/ntfy-notification.js

@@ -0,0 +1,2 @@
+export * from './providers/ntfy-notification/index.js';
+//# sourceMappingURL=ntfy-notification.js.map

package/lib/ntfy-notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-notification.js","sourceRoot":"","sources":["../src/ntfy-notification.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAA"}

package/lib/operations/cleanup-inspector.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { RunId } from '../admission.js';
+import type { CleanupPreview } from './model.js';
+import type { MaintenanceStateStore } from './store.js';
+export declare class CleanupInspector {
+    private readonly ctx;
+    private readonly store;
+    private readonly now;
+    codeHostFailure: string | undefined;
+    constructor(ctx: Context, store: MaintenanceStateStore, now: () => number);
+    inspect(runId: RunId): Promise<{
+        preview: Omit<CleanupPreview, 'previewId'>;
+        fingerprint: string;
+    }>;
+    private observeMerged;
+}