@rwoll/canvas-kit 0.0.0-placeholder → 0.1.0

package/dist/playwright.js

@@ -0,0 +1,124 @@
+import { defineConfig, devices, test as base } from '@playwright/test';
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, join, resolve } from 'node:path';
+import { StateStore, canvasDataDir } from "./server/storage.js";
+import { createTestCanvas } from "./testing.js";
+const DEFAULT_INSTANCE = 'test';
+/**
+ * Playwright fixtures for a canvas. Use the returned `test` like Playwright's own:
+ *
+ * ```ts
+ * export const test = canvasTest(canvas)
+ * test('adds a blocker', async ({ openCanvas, agent }) => { ... })
+ * ```
+ */
+export function canvasTest(canvas, options = {}) {
+    const uiDir = resolve(options.uiDir ?? join('dist', 'plugin', 'extensions', basename(process.cwd()), 'ui'));
+    const assertBuilt = () => {
+        if (!existsSync(join(uiDir, 'index.html'))) {
+            throw new Error(`No built canvas UI in ${uiDir}. Build the canvas first (for example \`pnpm build\`), or pass uiDir to canvasTest().`);
+        }
+    };
+    const release = options.release ?? localRelease();
+    return base.extend({
+        _canvasState: async ({}, use) => {
+            await use({ messages: [], failures: [], lastInstance: DEFAULT_INSTANCE });
+        },
+        canvasHarness: async ({ _canvasState }, use) => {
+            assertBuilt();
+            const harness = await createTestCanvas(canvas, {
+                uiDir,
+                release,
+                now: options.now,
+                sendToAgent: async (message) => {
+                    const failure = _canvasState.failures.shift();
+                    if (failure)
+                        throw failure;
+                    _canvasState.messages.push(message);
+                },
+            });
+            try {
+                await use(harness);
+            }
+            finally {
+                await harness.close();
+            }
+        },
+        openCanvas: async ({ canvasHarness, page, _canvasState }, use) => {
+            await use(async (input, { instanceId = DEFAULT_INSTANCE } = {}) => {
+                const { url } = await canvasHarness.open(instanceId, input);
+                _canvasState.lastInstance = instanceId;
+                await gotoLive(page, url);
+                return {
+                    page,
+                    url,
+                    instanceId,
+                    state: () => canvasHarness.state(instanceId),
+                    openAnotherPage: async () => {
+                        const another = await page.context().newPage();
+                        await gotoLive(another, url);
+                        return another;
+                    },
+                };
+            });
+        },
+        agent: async ({ canvasHarness, _canvasState }, use) => {
+            await use({
+                invoke: (action, input, { instanceId } = {}) => canvasHarness.invoke(instanceId ?? _canvasState.lastInstance, action, input, 'agent'),
+                messages: _canvasState.messages,
+                failNextSend: (error = new Error('The agent could not be reached')) => {
+                    _canvasState.failures.push(error);
+                },
+            });
+        },
+        seed: async ({ canvasHarness }, use) => {
+            await use(async (key, state) => {
+                if (!canvas.persist)
+                    throw new Error(`${canvas.id} does not set persist, so there is nothing to seed`);
+                const store = new StateStore(canvasDataDir(canvas.id, canvasHarness.dataRoot), canvas.state, canvas.persist.version);
+                await store.save(key, canvas.state.parse(state));
+            });
+        },
+        runJob: async ({ canvasHarness, _canvasState }, use) => {
+            await use((job, runOptions = {}) => canvasHarness.runJob(job, runOptions.key === undefined && runOptions.instanceId === undefined ? { ...runOptions, instanceId: _canvasState.lastInstance } : runOptions));
+        },
+    });
+}
+/** The footer of an unpublished build of the canvas package in the current folder. */
+function localRelease() {
+    const name = basename(process.cwd());
+    try {
+        const { version } = JSON.parse(readFileSync('package.json', 'utf8'));
+        return { name, version: version ?? '0.0.0', channel: 'local' };
+    }
+    catch {
+        return { name, version: '0.0.0', channel: 'local' };
+    }
+}
+/**
+ * Playwright config for canvas tests: specs in `e2e/`, run in light, dark, and
+ * high-contrast Chromium. Pass overrides as you would to `defineConfig`.
+ */
+export function defineCanvasConfig(config = {}) {
+    const chrome = devices['Desktop Chrome'];
+    return defineConfig({
+        testDir: 'e2e',
+        fullyParallel: true,
+        forbidOnly: Boolean(process.env.CI),
+        retries: process.env.CI ? 1 : 0,
+        reporter: process.env.CI ? [['github'], ['list']] : 'list',
+        use: { trace: 'retain-on-failure' },
+        projects: [
+            { name: 'light', use: { ...chrome, colorScheme: 'light' } },
+            { name: 'dark', use: { ...chrome, colorScheme: 'dark' } },
+            { name: 'high-contrast', use: { ...chrome, colorScheme: 'dark', contextOptions: { forcedColors: 'active' } } },
+        ],
+        ...config,
+    });
+}
+async function gotoLive(page, url) {
+    await page.goto(url);
+    await page.locator('html[data-canvas-status="live"]').waitFor({ state: 'attached' });
+}
+export { expect } from '@playwright/test';
+//# sourceMappingURL=playwright.js.map

package/dist/playwright.js.map

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

package/dist/react.d.ts

@@ -0,0 +1,55 @@
+import { CanvasActionError, type AddJobOptions, type CanvasSnapshot, type InputArgs, type RunAction } from './client.ts';
+import type { ActionResult, AnyCanvas, JobInput, JobStatusOf, JobWithInputName, StateOf, UiActionName } from './define.ts';
+import type { Interval, JobDefinitionInfo } from './jobs.ts';
+export { CanvasActionError, CanvasClient, formatInterval, getCanvasClient, intervalMs } from './client.ts';
+export type { AddJobOptions, CanvasSnapshot, ConnectionStatus, Interval, JobDefinitionInfo, JobStatus, RunAction } from './client.ts';
+export interface UseCanvas<C extends AnyCanvas> extends CanvasSnapshot<StateOf<C>> {
+    run: RunAction<C>;
+}
+/**
+ * Live canvas state and a typed action caller. Pass the canvas type with
+ * `import type canvas from '../server/canvas.ts'` and `useCanvas<typeof canvas>()`.
+ */
+export declare function useCanvas<C extends AnyCanvas>(): UseCanvas<C>;
+export interface ActionState {
+    pending: boolean;
+    error: CanvasActionError | undefined;
+}
+/** A single action with its pending and error state, for buttons and forms. */
+export declare function useAction<C extends AnyCanvas, K extends UiActionName<C>>(name: K): [(...args: InputArgs<C, K>) => Promise<ActionResult<C, K> | undefined>, ActionState];
+export interface UseJobs<C extends AnyCanvas> {
+    /** The document's jobs, live: one per declared job, then the jobs added from jobs with input. */
+    jobs: readonly JobStatusOf<C>[];
+    /** The jobs the canvas declares, for forms that add jobs. */
+    definitions: readonly JobDefinitionInfo[];
+    /** Pause or resume a job, or change its interval. Resolves to its new status, or undefined when it failed. */
+    update(id: string, patch: {
+        enabled?: boolean;
+        every?: Interval;
+    }): Promise<JobStatusOf<C> | undefined>;
+    /** Run a job now, even if paused. */
+    run(id: string): Promise<JobStatusOf<C> | undefined>;
+    /** Add a job from a job with input. Resolves to its status, with its new ID. */
+    add<K extends JobWithInputName<C>>(job: K, input: JobInput<C, K>, options?: AddJobOptions): Promise<JobStatusOf<C> | undefined>;
+    /** Remove a job added from a job with input. Resolves to whether it was removed. */
+    remove(id: string): Promise<boolean>;
+    /** IDs of jobs with a call in flight, and the names of jobs being added from. */
+    pending: ReadonlySet<string>;
+    /** The last call's failure, cleared by the next call. */
+    error: CanvasActionError | undefined;
+}
+/**
+ * The document's scheduled jobs, live, with calls to control the ones whose
+ * `controls` include the UI.
+ */
+export declare function useJobs<C extends AnyCanvas>(): UseJobs<C>;
+/**
+ * Hooks bound to one canvas type, so action names and inputs are inferred:
+ * `const { useCanvas, useAction, useJobs } = createCanvasHooks<typeof canvas>();`
+ */
+export declare function createCanvasHooks<C extends AnyCanvas>(): {
+    useCanvas: () => UseCanvas<C>;
+    useAction: <K extends UiActionName<C>>(name: K) => [(...args: InputArgs<C, K>) => Promise<ActionResult<C, K> | undefined>, ActionState];
+    useJobs: () => UseJobs<C>;
+};
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

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

package/dist/react.js

@@ -0,0 +1,72 @@
+import { useCallback, useMemo, useState, useSyncExternalStore } from 'react';
+import { CanvasActionError, getCanvasClient } from "./client.js";
+export { CanvasActionError, CanvasClient, formatInterval, getCanvasClient, intervalMs } from "./client.js";
+/**
+ * Live canvas state and a typed action caller. Pass the canvas type with
+ * `import type canvas from '../server/canvas.ts'` and `useCanvas<typeof canvas>()`.
+ */
+export function useCanvas() {
+    const client = getCanvasClient();
+    const snapshot = useSyncExternalStore(client.subscribe, client.getSnapshot);
+    return { ...snapshot, run: client.run };
+}
+/** A single action with its pending and error state, for buttons and forms. */
+export function useAction(name) {
+    const client = getCanvasClient();
+    const [state, setState] = useState({ pending: false, error: undefined });
+    const call = useCallback(async (...args) => {
+        setState({ pending: true, error: undefined });
+        try {
+            const result = await client.run(name, ...args);
+            setState({ pending: false, error: undefined });
+            return result;
+        }
+        catch (error) {
+            const failure = error instanceof CanvasActionError ? error : new CanvasActionError('request_failed', String(error));
+            setState({ pending: false, error: failure });
+            return undefined;
+        }
+    }, [client, name]);
+    return [call, state];
+}
+/**
+ * The document's scheduled jobs, live, with calls to control the ones whose
+ * `controls` include the UI.
+ */
+export function useJobs() {
+    const client = getCanvasClient();
+    const snapshot = useSyncExternalStore(client.subscribe, client.getSnapshot);
+    const [pending, setPending] = useState(new Set());
+    const [error, setError] = useState();
+    const track = useCallback((key, call) => {
+        setError(undefined);
+        setPending(current => new Set(current).add(key));
+        return call().then(result => result, (failure) => {
+            setError(failure instanceof CanvasActionError ? failure : new CanvasActionError('request_failed', String(failure)));
+            return undefined;
+        }).finally(() => setPending(current => {
+            const next = new Set(current);
+            next.delete(key);
+            return next;
+        }));
+    }, []);
+    const calls = useMemo(() => ({
+        update: (id, patch) => track(id, () => client.updateJob(id, patch)),
+        run: (id) => track(id, () => client.runJob(id)),
+        add: (job, input, options) => track(job, () => client.addJob(job, input, options)),
+        remove: async (id) => (await track(id, () => client.removeJob(id).then(() => true))) ?? false,
+    }), [client, track]);
+    return { jobs: snapshot.jobs, definitions: client.jobDefinitions, ...calls, pending, error };
+}
+/**
+ * Hooks bound to one canvas type, so action names and inputs are inferred:
+ * `const { useCanvas, useAction, useJobs } = createCanvasHooks<typeof canvas>();`
+ */
+export function createCanvasHooks() {
+    return {
+        useCanvas: () => useCanvas(),
+        useAction: (name) => useAction(name),
+        useJobs: () => useJobs(),
+    };
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/server/headless.d.ts

@@ -0,0 +1,20 @@
+import { type AnyCanvas, type LogLevel } from '../define.ts';
+import { type JobOutcome } from './host.ts';
+export interface RunCanvasJobOptions {
+    /** Run jobs for this saved document only. Defaults to every saved document. */
+    key?: string;
+    /** Run even if not due or paused. */
+    force?: boolean;
+    /** Parent of the per-canvas data folders. Defaults to `<copilot-home>/extension-data`. */
+    dataRoot?: string;
+    log?: (message: string, level: LogLevel) => void;
+}
+/**
+ * Run scheduled jobs for saved documents with no chat or agent, as `canvas-kit run`
+ * does. `job` selects every job (undefined), the jobs with one name (including those
+ * added from a job with input), or the job with one ID. Each runs only when due and
+ * not paused (unless `force`), under the same lock chats use, so it is safe while
+ * chats have the canvas open.
+ */
+export declare function runCanvasJob(canvas: AnyCanvas, job?: string, options?: RunCanvasJobOptions): Promise<JobOutcome[]>;
+//# sourceMappingURL=headless.d.ts.map

package/dist/server/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../src/server/headless.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoB5H"}

package/dist/server/headless.js

@@ -0,0 +1,35 @@
+import { jobForId } from "../define.js";
+import { CanvasKitError, errorMessage } from "../errors.js";
+import { CanvasHost } from "./host.js";
+/**
+ * Run scheduled jobs for saved documents with no chat or agent, as `canvas-kit run`
+ * does. `job` selects every job (undefined), the jobs with one name (including those
+ * added from a job with input), or the job with one ID. Each runs only when due and
+ * not paused (unless `force`), under the same lock chats use, so it is safe while
+ * chats have the canvas open.
+ */
+export async function runCanvasJob(canvas, job, options = {}) {
+    if (job !== undefined)
+        jobForId(canvas, job);
+    if (!canvas.persist) {
+        throw new CanvasKitError('invalid_input', `${canvas.title} does not save documents, so its jobs run only while a chat has it open.`);
+    }
+    const host = new CanvasHost(canvas, { dataRoot: options.dataRoot, jobs: 'manual', watch: false, log: options.log });
+    try {
+        const keys = options.key !== undefined ? [options.key] : await host.savedKeys();
+        const outcomes = [];
+        for (const key of keys) {
+            try {
+                outcomes.push(...(await host.runJobs(job, { key, force: options.force ?? false, headless: true })));
+            }
+            catch (error) {
+                outcomes.push({ id: job ?? '*', job: job ?? '*', key, ran: false, error: errorMessage(error) });
+            }
+        }
+        return outcomes;
+    }
+    finally {
+        await host.close();
+    }
+}
+//# sourceMappingURL=headless.js.map

package/dist/server/headless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.js","sourceRoot":"","sources":["../../src/server/headless.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiC,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AAYxD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAiB,EAAE,GAAY,EAAE,UAA+B,EAAE;IACnG,IAAI,GAAG,KAAK,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,cAAc,CAAC,eAAe,EAAE,GAAG,MAAM,CAAC,KAAK,0EAA0E,CAAC,CAAC;IACvI,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpH,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAChF,MAAM,QAAQ,GAAiB,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACtG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/server/host.d.ts

@@ -0,0 +1,146 @@
+import { type IncomingMessage, type ServerResponse } from 'node:http';
+import { type ActionSource, type AgentMessage, type AnyCanvas, type LogLevel } from '../define.ts';
+import { type JobDefinitionInfo, type JobStatus } from '../jobs.ts';
+import { type ReleaseInfo } from './release.ts';
+import { type StateStoreOptions } from './storage.ts';
+export interface CanvasHostOptions {
+    /** Folder with the built UI (`index.html` and assets). Omit to serve a bare page, as in tests. */
+    uiDir?: string;
+    /** Parent of the per-canvas data folders. Defaults to `<copilot-home>/extension-data`. */
+    dataRoot?: string;
+    /** Build shown in the page footer and sent to the UI. */
+    release?: ReleaseInfo;
+    /** Delivers `ctx.sendToAgent()` messages. Without it, sending fails with `agent_unavailable`. */
+    sendToAgent?: (message: AgentMessage) => Promise<void>;
+    log?: (message: string, level: LogLevel) => void;
+    /** The clock for `ctx.now()` and job schedules. Defaults to `Date.now`. */
+    now?: () => number;
+    /**
+     * `auto` (default) runs due jobs on a timer while documents are open; `manual`
+     * runs them only through `runJob()` and `tickJobs()`, as tests do.
+     */
+    jobs?: 'auto' | 'manual';
+    /** Watch saved documents so changes from other chats reach open pages. Defaults to true. */
+    watch?: boolean;
+    /**
+     * How often to check open documents for changes that file watching missed, in
+     * milliseconds. Defaults to 2000.
+     */
+    watchPollMs?: number;
+    /** Cross-process lock timings for saved documents. */
+    store?: StateStoreOptions;
+}
+/** What running a job did for one document. */
+export interface JobOutcome {
+    /** The job's ID: its name, or the ID of a job added from a job with input. */
+    id: string;
+    job: string;
+    key: string | undefined;
+    /** False when the job was not due yet, or paused. */
+    ran: boolean;
+    /** True when it did not run because it is paused. */
+    paused?: boolean;
+    /** The error message when the job failed. Its state changes were rolled back. */
+    error?: string;
+}
+export interface RunJobOptions {
+    /** Run it for this open instance's document. */
+    instanceId?: string;
+    /** Run it for the saved document with this persist key, open or not. */
+    key?: string;
+    /** Run even if it is not due. Defaults to true. */
+    force?: boolean;
+    /** Mark the run as headless (`ctx.headless`), as `canvas-kit run` does. */
+    headless?: boolean;
+}
+export interface OpenRequest {
+    instanceId: string;
+    input?: unknown;
+}
+export interface OpenResult {
+    url: string;
+    title: string;
+    status?: string;
+}
+export interface InvokeRequest {
+    instanceId: string;
+    actionName: string;
+    input?: unknown;
+    source: ActionSource;
+}
+export interface StateSnapshot {
+    revision: number;
+    state: unknown;
+    /** The document's jobs, for a canvas with jobs. */
+    jobs?: JobStatus[];
+}
+/** Data the server embeds in the page for the client library. */
+export interface CanvasBootstrap extends StateSnapshot {
+    base: string;
+    token: string;
+    release?: ReleaseInfo;
+    /** The jobs the canvas declares, for a canvas with jobs. */
+    jobDefinitions?: JobDefinitionInfo[];
+}
+/** The page's Content-Security-Policy: strict defaults plus the canvas's own `csp` sources. */
+export declare function contentSecurityPolicy(csp: AnyCanvas['csp']): string;
+export declare function renderBootstrap(bootstrap: CanvasBootstrap): string;
+export declare function injectBootstrap(html: string, bootstrap: CanvasBootstrap): string;
+/**
+ * Runs one canvas definition: instance lifecycle, serialized actions, state
+ * persistence, and the loopback HTTP server that serves the UI and live state.
+ *
+ * Locks: `i:<instanceId>` serializes open, close, and actions for one instance;
+ * the slot lock serializes state changes for one document. Instance locks are
+ * always taken before slot locks.
+ */
+export declare class CanvasHost {
+    #private;
+    readonly canvas: AnyCanvas;
+    constructor(canvas: AnyCanvas, options?: CanvasHostOptions);
+    log(message: string, level?: LogLevel): void;
+    /** Open or reopen an instance and return the URL of its page. */
+    open(request: OpenRequest): Promise<OpenResult>;
+    /** Open an instance without starting the HTTP server, as the Vite dev server does. */
+    openLocal(request: OpenRequest): Promise<CanvasBootstrap>;
+    /** Page bootstrap data for an open instance, without reopening it. */
+    bootstrapFor(instanceId: string, base: string): CanvasBootstrap | undefined;
+    invoke(request: InvokeRequest): Promise<unknown>;
+    snapshot(instanceId: string): StateSnapshot | undefined;
+    /** Close an instance. The HTTP server stops once no instances remain. */
+    closeInstance(instanceId: string): Promise<void>;
+    /** Close every instance, stop jobs and file watching, and stop the HTTP server. */
+    close(): Promise<void>;
+    /**
+     * Run every due job once for every open document. With `jobs: 'auto'` the host
+     * calls this on a timer; failures are logged.
+     */
+    tickJobs(): Promise<void>;
+    /**
+     * Run a job now for one document: an open instance's (`instanceId`), a saved
+     * document's (`key`), or the only open document. `id` is a job's name, or the ID
+     * of a job added from a job with input. Runs even if not due unless `force: false`.
+     */
+    runJob(id: string, options?: RunJobOptions): Promise<JobOutcome>;
+    /**
+     * Run one document's due jobs, as `canvas-kit run` does: every job, the jobs with
+     * one name (including the jobs added from a job with input), or the job with one ID.
+     * `force` runs them even if not due or paused.
+     */
+    runJobs(selector: string | undefined, options?: RunJobOptions): Promise<JobOutcome[]>;
+    /** The persist keys of every saved document, for running jobs without an open canvas. */
+    savedKeys(): Promise<string[]>;
+    /**
+     * Handle `__canvas/*` API requests for one instance. `path` is relative to the
+     * instance base, for example `__canvas/events`.
+     */
+    handleApi(instanceId: string, path: string, request: IncomingMessage, response: ServerResponse): Promise<void>;
+    /**
+     * Run an action as the agent would through the Copilot host. Only the Vite
+     * dev server uses this, so canvas UIs can be checked without an agent.
+     */
+    runDevAgentAction(instanceId: string, actionName: string, request: IncomingMessage, response: ServerResponse): Promise<void>;
+    /** Report a request failure as JSON without leaking unexpected error details. */
+    sendError(response: ServerResponse, error: unknown): void;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/server/host.d.ts.map

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