@supportpages.io/wtfm 0.0.0-stage → 0.3.0

package/dist/runs.js

@@ -0,0 +1,146 @@
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { remoteId, remoteArticleSchema } from './schema.js';
+import { parse } from './artifacts.js';
+import { fail } from './errors.js';
+import { articleLink } from './article-link.js';
+import { repositoryInvitationSchema } from './repository-benefits.js';
+import { hostingInvitationSchema } from './hosting-benefits.js';
+import { CLI_NAME } from './brand.js';
+export const processSessionId = randomUUID();
+export const runSchema = z.object({
+    id: z.uuid(), local_article_id: z.uuid(), artifact_dir: z.string(), started_at: z.string(),
+    section_id: remoteId.nullable(), status: z.enum(['prepared', 'finalized', 'cancelled', 'failed', 'interrupted']), skills_version: z.string(),
+    article_type: z.string().optional(),
+    progress: z.object({
+        attempt: z.uuid(), next_attempt: z.uuid().optional(), article: remoteArticleSchema.optional(),
+        sequence: z.number().int().nonnegative(), article_hash: z.string().optional(),
+        image_hashes: z.record(z.string(), z.string()).optional(), last_heartbeat: z.number().optional(),
+        open_attempted: z.boolean().optional(), browser_opened: z.boolean().optional(),
+        sync_error: z.string().optional(), sync_failures: z.number().int().nonnegative().optional(),
+        pending: z.object({ sequence: z.number().int().positive(), directory: z.string() }).optional(),
+    }).optional(),
+    title: z.string().optional(), api_origin: z.string().optional(), project_id: remoteId.optional(),
+    codebase_dir: z.string().optional(),
+    prefer_background: z.boolean().optional(), open_when_ready: z.boolean().optional(),
+    execution_mode: z.enum(['background', 'foreground']).optional(), host_task_id: z.string().max(200).optional(),
+    writer_token: z.uuid().optional(), writer_started_at: z.iso.datetime().optional(),
+    writer_completed_at: z.iso.datetime().optional(),
+    first_writer_started_at: z.iso.datetime().optional(), ready_for_review_at: z.iso.datetime().optional(),
+    repository_invitation: repositoryInvitationSchema.optional(), repository_reminder_checked: z.boolean().optional(),
+    hosting_invitation: hostingInvitationSchema.optional(), hosting_reminder_checked: z.boolean().optional(),
+    session_id: z.string().optional(), updated_at: z.string().optional(),
+    phase: z.enum(['prepared', 'writing', 'finalizing', 'uploading', 'upload_failed', 'ready_for_review', 'published', 'saved', 'failed', 'interrupted', 'cancelled']).optional(),
+    bundle_dir: z.string().optional(), bundle_hash: z.string().optional(),
+    // Preview exports do not mean the writer has finished or passed validation.
+    local_export: z.object({ directory: z.string(), markdown_path: z.string().optional(), sync_error: z.string().optional() }).optional(),
+    export_path: z.string().optional(),
+    remote: remoteArticleSchema.optional(),
+    error: z.object({ code: z.string(), message: z.string() }).optional(),
+});
+export function uploadRecovery(run) {
+    const reason = run.error?.code === 'plan_limit'
+        ? 'Free up article capacity or update the account plan.'
+        : ['permission_denied', 'invalid_credentials'].includes(run.error?.code ?? '')
+            ? `Check the token permissions and project access; reconnect with ${CLI_NAME} init if needed.`
+            : ['run_closed', 'revision_conflict', 'article_deleted', 'article_unavailable'].includes(run.error?.code ?? '')
+                ? 'Review the existing article in the web app. Do not overwrite browser changes or restart a closed run.'
+                : 'Resolve the reported upload problem.';
+    const retry = ['run_closed', 'revision_conflict', 'article_deleted', 'article_unavailable'].includes(run.error?.code ?? '') ? ''
+        : ` Then retry supportpages_complete_article with run_id=${run.id} and completed=true to reuse the saved bundle.`;
+    return `${reason}${retry} Do not regenerate the article or report the writer as failed because delivery failed. Local upload state does not prove that no remote draft exists.`;
+}
+export class Runs {
+    ws;
+    root;
+    sessionId;
+    constructor(ws, root, sessionId = processSessionId) {
+        this.ws = ws;
+        this.root = root;
+        this.sessionId = sessionId;
+    }
+    async read(id) {
+        parse(z.uuid(), id, 'invalid_run');
+        const file = `${this.root}/runs/${id}/run.json`;
+        if (!await this.ws.exists(file))
+            fail('invalid_run', 'This run does not belong to the selected workspace and API origin.');
+        const run = parse(runSchema, await this.ws.json(file));
+        if (run.id !== id)
+            fail('invalid_run', 'Run identity mismatch.');
+        return run;
+    }
+    // Caller holds the workspace operation lock for all writes and reservations.
+    async save(run) {
+        const previous = await this.ws.exists(`${this.root}/runs/${run.id}/run.json`) ? await this.read(run.id) : undefined;
+        const now = new Date().toISOString();
+        const value = { ...run, updated_at: now,
+            first_writer_started_at: previous?.first_writer_started_at ?? run.first_writer_started_at ?? previous?.writer_started_at ?? run.writer_started_at,
+            ready_for_review_at: previous?.ready_for_review_at ?? run.ready_for_review_at ?? (run.phase === 'ready_for_review' ? now : undefined),
+            repository_reminder_checked: previous?.repository_reminder_checked ?? run.repository_reminder_checked,
+            repository_invitation: previous?.repository_invitation ?? run.repository_invitation,
+            hosting_reminder_checked: previous?.hosting_reminder_checked ?? run.hosting_reminder_checked,
+            hosting_invitation: previous?.hosting_invitation ?? run.hosting_invitation };
+        await this.ws.writeJson(`${this.root}/runs/${run.id}/run.json`, value);
+        const activeFile = `${this.root}/active-run.json`;
+        if (await this.ws.exists(activeFile) && parse(runSchema, await this.ws.json(activeFile)).id === run.id) {
+            await this.ws.writeJson(activeFile, value);
+        }
+    }
+    async blocking(allowedId) {
+        // Include legacy active-run files. All environments share the skills' outputs.
+        const roots = ['.rtfm/supportpages'];
+        for (const entry of await this.ws.list('.rtfm/supportpages/dev')) {
+            if (entry.isDirectory())
+                roots.push(`.rtfm/supportpages/dev/${entry.name}`);
+        }
+        for (const root of roots) {
+            const file = `${root}/active-run.json`;
+            if (!await this.ws.exists(file))
+                continue;
+            const pointer = parse(runSchema, await this.ws.json(file));
+            const record = `${root}/runs/${pointer.id}/run.json`;
+            const active = await this.ws.exists(record) ? parse(runSchema, await this.ws.json(record)) : pointer;
+            if (active.status === 'prepared' && !(root === this.root && active.id === allowedId)) {
+                return { run: active, state_directory: root };
+            }
+        }
+        return null;
+    }
+    async assertAvailable(allowedId) {
+        const active = await this.blocking(allowedId);
+        if (active)
+            fail('generation_active', 'Finish or stop and cancel the existing writer before starting another in this workspace.', { run_id: active.run.id, state_directory: active.state_directory });
+    }
+    async progress(id) {
+        let run;
+        if (id)
+            run = await this.read(id);
+        else {
+            if (!await this.ws.exists(`${this.root}/active-run.json`))
+                return null;
+            const active = parse(runSchema, await this.ws.json(`${this.root}/active-run.json`));
+            run = await this.read(active.id);
+        }
+        // Interpret older journals without rewriting them: a finalized run whose
+        // delivery failed is still a completed local article, not a failed writer.
+        const uploadFailed = run.phase === 'upload_failed' || (run.status === 'finalized' && run.phase === 'failed');
+        const deliveryPending = Boolean(run.writer_completed_at && !run.remote && run.phase !== 'saved');
+        return { run_id: run.id, title: run.title, phase: uploadFailed ? 'upload_failed' : run.phase ?? (run.status === 'finalized' ? 'finalizing' : run.status),
+            generation_completed_locally: run.status === 'finalized',
+            delivery_pending: deliveryPending,
+            recovery: uploadFailed ? uploadRecovery(run) : deliveryPending
+                ? (run.project_id
+                    ? `Writing has finished but final delivery is pending. Call supportpages_complete_article with run_id=${run.id} and completed=true; do not regenerate or claim the editor is ready.`
+                    : `Writing has finished but the article has not been saved yet. Call supportpages_complete_article with run_id=${run.id} and completed=true to save it; do not regenerate.`) : undefined,
+            artifact_dir: run.artifact_dir, execution_mode: run.execution_mode, host_task_id: run.host_task_id,
+            progress_source: 'last_reported', session_current: run.session_id === this.sessionId,
+            started_at: run.started_at, updated_at: run.updated_at ?? run.started_at,
+            project_id: run.project_id, error: run.error, article: run.remote, export_path: run.export_path,
+            preview: run.progress?.article, local_preview_path: run.local_export?.markdown_path,
+            synchronization_error: run.progress?.sync_error ?? run.local_export?.sync_error,
+            ...articleLink(run), open_when_ready: Boolean(run.open_when_ready && !run.progress?.open_attempted), browser_opened: run.progress?.browser_opened,
+            instructions: run.status === 'prepared' && run.session_id !== this.sessionId
+                ? 'Progress is from an earlier MCP session. Verify the host task before completing, stopping, or restarting it; do not start a duplicate writer.' : undefined };
+    }
+}
+//# sourceMappingURL=runs.js.map

package/dist/runs.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,12 @@
+import { spawn } from 'node:child_process';
+/** Only the managed versions/<release>/mcp layout can update itself. */
+export declare function installationRoot(installRoot: string): string | undefined;
+export declare function autoUpdateEnabled(env: NodeJS.ProcessEnv): boolean;
+/** Keep this session's engine on the same immutable release as its JS modules.
+ * Older installers registered the bundled skills by an absolute version path,
+ * first as mcp/skills and now as mcp/engine; both map to this release's engine.
+ * External engine checkouts remain exactly the user's choice.
+ */
+export declare function pinSkills(installRoot: string, skillsDir: string): Promise<string>;
+/** No inherited protocol streams, no waiting, and no prompts in an agent session. */
+export declare function startBackgroundUpdate(installRoot: string, env?: NodeJS.ProcessEnv, spawnProcess?: typeof spawn): void;

package/dist/runtime.js

@@ -0,0 +1,58 @@
+import path from 'node:path';
+import { access, realpath } from 'node:fs/promises';
+import { spawn } from 'node:child_process';
+/** Only the managed versions/<release>/mcp layout can update itself. */
+export function installationRoot(installRoot) {
+    const version = path.dirname(installRoot);
+    if (path.basename(installRoot) !== 'mcp' || path.basename(path.dirname(version)) !== 'versions')
+        return;
+    return path.dirname(path.dirname(version));
+}
+export function autoUpdateEnabled(env) {
+    return !['0', 'false', 'off'].includes((env.SUPPORTPAGES_AUTO_UPDATE ?? '').toLowerCase()) &&
+        (!env.CI || ['0', 'false'].includes(env.CI.toLowerCase()));
+}
+/** Keep this session's engine on the same immutable release as its JS modules.
+ * Older installers registered the bundled skills by an absolute version path,
+ * first as mcp/skills and now as mcp/engine; both map to this release's engine.
+ * External engine checkouts remain exactly the user's choice.
+ */
+export async function pinSkills(installRoot, skillsDir) {
+    const root = installationRoot(installRoot);
+    if (root) {
+        const relative = path.relative(root, skillsDir).split(path.sep);
+        const bundledName = (name) => name === 'skills' || name === 'engine';
+        // Skills copies that earlier setups kept in the shared data directory
+        // (<data>/skills/<name>, beside <data>/cli) are managed too.
+        const shared = path.relative(path.join(path.dirname(root), 'skills'), skillsDir).split(path.sep);
+        const bundled = (relative.length === 3 && relative[0] === 'current' && relative[1] === 'mcp' && bundledName(relative[2])) ||
+            (relative.length === 4 && relative[0] === 'versions' && relative[2] === 'mcp' && bundledName(relative[3])) ||
+            (shared.length === 1 && shared[0] !== '' && shared[0] !== '..');
+        if (bundled) {
+            const candidate = path.join(installRoot, 'engine');
+            try {
+                await access(path.join(candidate, 'generate-illustrated-article', 'SKILL.md'));
+                skillsDir = candidate;
+            }
+            catch { /* An older release without an engine keeps its registered skills. */ }
+        }
+    }
+    return realpath(skillsDir).catch(() => skillsDir);
+}
+/** No inherited protocol streams, no waiting, and no prompts in an agent session. */
+export function startBackgroundUpdate(installRoot, env = process.env, spawnProcess = spawn) {
+    if (!autoUpdateEnabled(env) || !installationRoot(installRoot))
+        return;
+    const safeEnv = { ...env };
+    delete safeEnv.SUPPORTPAGES_API_TOKEN;
+    delete safeEnv.SUPPORTPAGES_API_TOKEN_FILE;
+    try {
+        const child = spawnProcess(process.execPath, [path.join(installRoot, 'scripts/auto-update.mjs')], {
+            cwd: installRoot, env: safeEnv, detached: true, stdio: 'ignore',
+        });
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch { /* Updating must never prevent a connection. */ }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,277 @@
+import { z } from 'zod';
+export declare const idSchema: z.ZodString;
+export declare const remoteId: z.ZodString;
+export declare const articleType: z.ZodEnum<{
+    "how-to": "how-to";
+    troubleshooting: "troubleshooting";
+    concept: "concept";
+    faq: "faq";
+}>;
+export declare const articleSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    title: z.ZodString;
+    article_type: z.ZodEnum<{
+        "how-to": "how-to";
+        troubleshooting: "troubleshooting";
+        concept: "concept";
+        faq: "faq";
+    }>;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"prose">;
+        presentation: z.ZodEnum<{
+            lead: "lead";
+            body: "body";
+            summary: "summary";
+        }>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"section">;
+        presentation: z.ZodEnum<{
+            numbered: "numbered";
+            plain: "plain";
+        }>;
+        title: z.ZodString;
+        content: z.ZodString;
+        has_image: z.ZodBoolean;
+        id: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"list">;
+        presentation: z.ZodEnum<{
+            bullets: "bullets";
+            checklist: "checklist";
+            tips: "tips";
+        }>;
+        title: z.ZodString;
+        items: z.ZodArray<z.ZodString>;
+        id: z.ZodString;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>;
+export type Article = z.infer<typeof articleSchema>;
+export declare const manifestSchema: z.ZodObject<{
+    bundle_version: z.ZodLiteral<1>;
+    local_article_id: z.ZodUUID;
+    run_id: z.ZodUUID;
+    skills_version: z.ZodString;
+    source_commit: z.ZodNullable<z.ZodString>;
+    source_dirty: z.ZodBoolean;
+    section_id: z.ZodNullable<z.ZodString>;
+    article_sha256: z.ZodString;
+    images: z.ZodArray<z.ZodObject<{
+        block_id: z.ZodString;
+        filename: z.ZodString;
+        sha256: z.ZodString;
+        size: z.ZodNumber;
+        mime_type: z.ZodLiteral<"image/png">;
+    }, z.core.$strict>>;
+    bundle_hash: z.ZodString;
+}, z.core.$strict>;
+export type Manifest = z.infer<typeof manifestSchema>;
+export declare const bindingSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    project_id: z.ZodString;
+    api_origin: z.ZodURL;
+}, z.core.$strict>;
+export type Binding = z.infer<typeof bindingSchema>;
+/** A workspace that saves finished articles locally instead of (or before) uploading them. */
+export declare const localSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    export_dir: z.ZodString;
+    writing_style: z.ZodOptional<z.ZodString>;
+    preferences: z.ZodOptional<z.ZodObject<{
+        prefer_background: z.ZodBoolean;
+        open_when_ready: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strict>;
+export type LocalSettings = z.infer<typeof localSchema>;
+export declare const repositoryConnectionSchema: z.ZodObject<{
+    writer: z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        actions: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Partial<Record<"read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre", {
+            action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+            allowed: boolean;
+            execution: "local" | "remote" | "hosted";
+            required_scopes: string[];
+            next_step: {
+                code: string;
+                message: string;
+                requested_action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                missing_scopes?: ("read" | "import" | "publish" | "manage" | "generate")[] | undefined;
+                url?: string | undefined;
+            } | null;
+        }>>, Record<string, unknown>>>;
+    }, z.core.$strip>>;
+    state: z.ZodEnum<{
+        not_connected: "not_connected";
+        connected: "connected";
+        disconnected: "disconnected";
+        suspended: "suspended";
+    }>;
+    connect_url: z.ZodURL;
+    capabilities: z.ZodObject<{
+        sections: z.ZodBoolean;
+        suggestions: z.ZodBoolean;
+        code_analysis: z.ZodBoolean;
+        maintenance: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const remoteArticleSchema: z.ZodObject<{
+    repository_connection: z.ZodOptional<z.ZodObject<{
+        writer: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            actions: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Partial<Record<"read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre", {
+                action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                allowed: boolean;
+                execution: "local" | "remote" | "hosted";
+                required_scopes: string[];
+                next_step: {
+                    code: string;
+                    message: string;
+                    requested_action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                    missing_scopes?: ("read" | "import" | "publish" | "manage" | "generate")[] | undefined;
+                    url?: string | undefined;
+                } | null;
+            }>>, Record<string, unknown>>>;
+        }, z.core.$strip>>;
+        state: z.ZodEnum<{
+            not_connected: "not_connected";
+            connected: "connected";
+            disconnected: "disconnected";
+            suspended: "suspended";
+        }>;
+        connect_url: z.ZodURL;
+        capabilities: z.ZodObject<{
+            sections: z.ZodBoolean;
+            suggestions: z.ZodBoolean;
+            code_analysis: z.ZodBoolean;
+            maintenance: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    id: z.ZodString;
+    revision: z.ZodString;
+    status: z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>;
+    editor_url: z.ZodURL;
+    public_url: z.ZodNullable<z.ZodURL>;
+}, z.core.$strip>;
+export declare const importResponseSchema: z.ZodObject<{
+    import_id: z.ZodString;
+    article: z.ZodObject<{
+        repository_connection: z.ZodOptional<z.ZodObject<{
+            writer: z.ZodOptional<z.ZodObject<{
+                version: z.ZodLiteral<1>;
+                actions: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Partial<Record<"read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre", {
+                    action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                    allowed: boolean;
+                    execution: "local" | "remote" | "hosted";
+                    required_scopes: string[];
+                    next_step: {
+                        code: string;
+                        message: string;
+                        requested_action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                        missing_scopes?: ("read" | "import" | "publish" | "manage" | "generate")[] | undefined;
+                        url?: string | undefined;
+                    } | null;
+                }>>, Record<string, unknown>>>;
+            }, z.core.$strip>>;
+            state: z.ZodEnum<{
+                not_connected: "not_connected";
+                connected: "connected";
+                disconnected: "disconnected";
+                suspended: "suspended";
+            }>;
+            connect_url: z.ZodURL;
+            capabilities: z.ZodObject<{
+                sections: z.ZodBoolean;
+                suggestions: z.ZodBoolean;
+                code_analysis: z.ZodBoolean;
+                maintenance: z.ZodBoolean;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        id: z.ZodString;
+        revision: z.ZodString;
+        status: z.ZodEnum<{
+            draft: "draft";
+            published: "published";
+        }>;
+        editor_url: z.ZodURL;
+        public_url: z.ZodNullable<z.ZodURL>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const articleCapacitySchema: z.ZodObject<{
+    used: z.ZodNumber;
+    limit: z.ZodNullable<z.ZodNumber>;
+    can_create: z.ZodBoolean;
+    upgrade_url: z.ZodURL;
+    manage_articles_url: z.ZodURL;
+}, z.core.$strip>;
+export declare const contextSchema: z.ZodObject<{
+    local: z.ZodOptional<z.ZodBoolean>;
+    article_sync: z.ZodOptional<z.ZodBoolean>;
+    walkthrough_sync: z.ZodOptional<z.ZodBoolean>;
+    article_capacity: z.ZodOptional<z.ZodObject<{
+        used: z.ZodNumber;
+        limit: z.ZodNullable<z.ZodNumber>;
+        can_create: z.ZodBoolean;
+        upgrade_url: z.ZodURL;
+        manage_articles_url: z.ZodURL;
+    }, z.core.$strip>>;
+    progressive_articles: z.ZodOptional<z.ZodBoolean>;
+    repository_connection: z.ZodOptional<z.ZodObject<{
+        writer: z.ZodOptional<z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            actions: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodTransform<Partial<Record<"read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre", {
+                action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                allowed: boolean;
+                execution: "local" | "remote" | "hosted";
+                required_scopes: string[];
+                next_step: {
+                    code: string;
+                    message: string;
+                    requested_action: "read_articles" | "create_article" | "update_article" | "edit_article" | "publish_article" | "unpublish_article" | "delete_article" | "find_article_gaps" | "suggest_sections" | "recommend_articles" | "review_sections" | "review_recommendations" | "create_video_walkthrough" | "get_operation" | "generate_help_centre";
+                    missing_scopes?: ("read" | "import" | "publish" | "manage" | "generate")[] | undefined;
+                    url?: string | undefined;
+                } | null;
+            }>>, Record<string, unknown>>>;
+        }, z.core.$strip>>;
+        state: z.ZodEnum<{
+            not_connected: "not_connected";
+            connected: "connected";
+            disconnected: "disconnected";
+            suspended: "suspended";
+        }>;
+        connect_url: z.ZodURL;
+        capabilities: z.ZodObject<{
+            sections: z.ZodBoolean;
+            suggestions: z.ZodBoolean;
+            code_analysis: z.ZodBoolean;
+            maintenance: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    project: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        help_centre_url: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strip>;
+    supported_bundle_versions: z.ZodArray<z.ZodNumber>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        slug: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    articles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        section_id: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>>;
+    product_context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNull]>>>;
+    inventory_truncated: z.ZodDefault<z.ZodBoolean>;
+    project_overview: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    analysis_summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    writing_style: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/schema.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { writerCapabilitiesSchema } from './actions.js';
+export const idSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(120);
+export const remoteId = z.string().regex(/^[1-9][0-9]*$/);
+export const articleType = z.enum(['how-to', 'troubleshooting', 'concept', 'faq']);
+const text = z.string().max(200_000);
+const title = z.string().trim().min(1).max(500);
+const common = { id: idSchema };
+export const articleSchema = z.strictObject({
+    schema_version: z.literal(2), title, article_type: articleType,
+    blocks: z.array(z.discriminatedUnion('type', [
+        z.strictObject({ ...common, type: z.literal('prose'), presentation: z.enum(['lead', 'body', 'summary']), title: text.nullish(), content: text }),
+        z.strictObject({ ...common, type: z.literal('section'), presentation: z.enum(['numbered', 'plain']), title, content: text, has_image: z.boolean() }),
+        z.strictObject({ ...common, type: z.literal('list'), presentation: z.enum(['bullets', 'checklist', 'tips']), title, items: z.array(text).max(500) }),
+    ])).min(1).max(500),
+}).superRefine((article, ctx) => {
+    const ids = article.blocks.map(b => b.id);
+    if (new Set(ids).size !== ids.length)
+        ctx.addIssue({ code: 'custom', message: 'Block IDs must be unique', path: ['blocks'] });
+});
+const hash = z.string().regex(/^[a-f0-9]{64}$/);
+export const manifestSchema = z.strictObject({
+    bundle_version: z.literal(1), local_article_id: z.uuid(), run_id: z.uuid(),
+    skills_version: z.string().max(100), source_commit: z.string().nullable(), source_dirty: z.boolean(),
+    section_id: remoteId.nullable(), article_sha256: hash,
+    images: z.array(z.strictObject({ block_id: idSchema, filename: z.string(), sha256: hash, size: z.number().int().positive().max(10 * 1024 * 1024), mime_type: z.literal('image/png') })).max(30),
+    bundle_hash: hash,
+});
+export const bindingSchema = z.strictObject({ version: z.literal(1), project_id: remoteId, api_origin: z.url() });
+/** A workspace that saves finished articles locally instead of (or before) uploading them. */
+export const localSchema = z.strictObject({ version: z.literal(1), export_dir: z.string().min(1).max(500),
+    writing_style: z.string().max(100).optional(),
+    preferences: z.object({ prefer_background: z.boolean(), open_when_ready: z.boolean() }).optional() });
+export const repositoryConnectionSchema = z.object({
+    writer: writerCapabilitiesSchema.optional(),
+    state: z.enum(['not_connected', 'connected', 'disconnected', 'suspended']),
+    connect_url: z.url(),
+    capabilities: z.object({ sections: z.boolean(), suggestions: z.boolean(), code_analysis: z.boolean(), maintenance: z.boolean() }),
+});
+export const remoteArticleSchema = z.object({ repository_connection: repositoryConnectionSchema.optional(), id: remoteId, revision: hash, status: z.enum(['draft', 'published']), editor_url: z.url(), public_url: z.url().nullable() });
+export const importResponseSchema = z.object({ import_id: remoteId, article: remoteArticleSchema });
+const browserUrl = z.url().max(2000).refine(value => {
+    const url = new URL(value);
+    return ['http:', 'https:'].includes(url.protocol) && !url.username && !url.password;
+});
+export const articleCapacitySchema = z.object({
+    used: z.number().int().nonnegative(), limit: z.number().int().nonnegative().nullable(), can_create: z.boolean(),
+    upgrade_url: browserUrl, manage_articles_url: browserUrl,
+}).refine(value => value.can_create === (value.limit === null || value.used < value.limit));
+export const contextSchema = z.object({
+    local: z.boolean().optional(),
+    article_sync: z.boolean().optional(),
+    walkthrough_sync: z.boolean().optional(),
+    article_capacity: articleCapacitySchema.optional(),
+    progressive_articles: z.boolean().optional(),
+    repository_connection: repositoryConnectionSchema.optional(),
+    // A local workspace has no remote project; every bound path compares the id to a binding.
+    project: z.object({ id: remoteId.optional(), name: z.string(), help_centre_url: z.url().optional() }),
+    supported_bundle_versions: z.array(z.number()),
+    sections: z.array(z.object({ id: remoteId, name: z.string(), slug: z.string(), description: z.string().nullable().optional(), icon: z.string().nullable().optional() })),
+    articles: z.array(z.object({ id: remoteId, title: z.string(), section_id: remoteId.nullable() })).default([]),
+    product_context: z.record(z.string(), z.union([z.string(), z.array(z.string()), z.null()])).optional(),
+    inventory_truncated: z.boolean().default(false),
+    project_overview: z.string().nullable().optional(), analysis_summary: z.string().nullable().optional(), writing_style: z.string().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Session } from './session.js';
+import type { Bridge } from './bridge.js';
+export declare function createServer(source: Bridge | Session): McpServer;