@copylee/dsh-office 0.1.0

package/lib/types/client/accent.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The accent colour shared by the copylee DSH plugins (docs/ui-spec.md).
+ *
+ * One choice — terracotta orange by default, blue or black — is kept in the
+ * browser under a key every plugin reads, and painted as two CSS variables on
+ * `<body>`, where the Host keeps its own theme variables. A plugin's styles
+ * only ever write `var(--cl-accent)` / `var(--cl-accent-ink)`, so changing the
+ * colour in any plugin's settings recolours all of them at once.
+ *
+ * This file is identical in every plugin; change it in all of them together.
+ */
+import * as React from 'react';
+export type Accent = 'orange' | 'blue' | 'black';
+export declare const ACCENTS: Record<Accent, {
+    name: string;
+    accent: string;
+    ink: string;
+}>;
+export declare const ACCENT_IDS: Accent[];
+export declare const DEFAULT_ACCENT: Accent;
+/** Use these in styles; the fallbacks cover the moment before the first paint. */
+export declare const ACCENT: string;
+export declare const ACCENT_INK: string;
+export declare function isAccent(value: unknown): value is Accent;
+/** The choice made in this browser, or null while none has been made. */
+export declare function storedAccent(): Accent | null;
+export declare function readAccent(): Accent;
+/** Choose the accent for every plugin. */
+export declare function writeAccent(accent: Accent): void;
+/** Paint the current accent and keep it current. Returns the undo for plugin disposal. */
+export declare function installAccent(): () => void;
+export declare function useAccent(): [Accent, (accent: Accent) => void];
+/** A row of round swatches: one of them is always chosen. */
+export declare function AccentPicker({ label, hint, names }: {
+    label?: string;
+    hint?: string;
+    /** Colour names in the page's language; the built-in ones are Chinese. */
+    names?: Partial<Record<Accent, string>>;
+}): React.ReactElement;

package/lib/types/client/index.d.ts

@@ -0,0 +1,39 @@
+type RemoteResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: {
+        code?: string;
+        message: string;
+    };
+};
+interface NamespaceView {
+    ns: string;
+    value: unknown;
+    revision: number;
+}
+interface ClientContext {
+    effect(execute: () => (() => void) | void, label?: string): void;
+    slots: {
+        inject(name: string, register: () => unknown): void;
+        register(meta: Record<string, unknown>, render: (props: unknown) => unknown): unknown;
+    };
+    remote: {
+        $on?(event: string, listener: (...args: unknown[]) => void): () => void;
+        settings: {
+            describe(): Promise<RemoteResult<{
+                writable: boolean;
+                namespaces: NamespaceView[];
+            }>>;
+            mutate(ns: string, ops: {
+                op: 'set' | 'unset';
+                path: string[];
+                value?: unknown;
+            }[], expectedRevision?: number): Promise<RemoteResult<unknown>>;
+        };
+    };
+}
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): void;
+export {};

package/lib/types/client/nav-icon.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Give the "Office" row in the DSH settings navigation a document icon
+ * instead of the shell's fallback gear.
+ *
+ * `settings.section` registrations only carry `id`, `order` and `label`; the
+ * shell picks icons for built-in ids only. So the row is marked by its label
+ * and CSS swaps the glyph (Lucide file-text, drawn as a currentColor mask so
+ * hover / active colors still apply).
+ */
+export declare const navIconCss = "\n[data-dsh-office-settings-nav] > svg:first-child { display: none; }\n[data-dsh-office-settings-nav]::before {\n  content: '';\n  flex: none;\n  width: 16px;\n  height: 16px;\n  background: currentColor;\n  -webkit-mask: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z'/%3E%3Cpath d='M14 2v4a2 2 0 0 0 2 2h4'/%3E%3Cpath d='M10 9H8'/%3E%3Cpath d='M16 13H8'/%3E%3Cpath d='M16 17H8'/%3E%3C/svg%3E\") center / contain no-repeat;\n  mask: url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='24' height='24' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z'/%3E%3Cpath d='M14 2v4a2 2 0 0 0 2 2h4'/%3E%3Cpath d='M10 9H8'/%3E%3Cpath d='M16 13H8'/%3E%3Cpath d='M16 17H8'/%3E%3C/svg%3E\") center / contain no-repeat;\n}\n";
+/** Keep the marker on the settings-nav button labelled `label`; returns a disposer. */
+export declare function registerNavIcon(label: string): () => void;

package/lib/types/format.d.ts

@@ -0,0 +1,88 @@
+/**
+ * What the helper reports, turned into the short plain text the model reads.
+ * Kept terse: every line here is paid for on each later request of the turn.
+ */
+export type AppKind = 'word' | 'excel' | 'ppt';
+export declare const APP_NAMES: Record<AppKind, string>;
+export interface DocInfo {
+    app: AppKind;
+    name: string;
+    path: string | null;
+    saved: boolean;
+    active: boolean;
+    readOnly?: boolean;
+    how?: 'attached' | 'opened' | 'created';
+}
+export interface AppStatus {
+    app: AppKind;
+    installed: boolean;
+    running: boolean;
+    version?: string;
+    error?: string;
+    documents: DocInfo[];
+}
+export interface WordItem {
+    i: number;
+    text?: string;
+    style?: string;
+    level?: number;
+    to?: number;
+    table?: number;
+    size?: string;
+}
+export interface WordRead {
+    paragraphs: number;
+    tables: number;
+    pages?: number;
+    from?: number;
+    items?: WordItem[];
+    more?: string;
+    table?: number;
+    cells?: Array<Array<string | null>>;
+}
+export interface ExcelRead {
+    sheets: Array<{
+        name: string;
+        used: string;
+        charts?: number;
+    }>;
+    sheet: string;
+    range: string;
+    values: unknown[][];
+    formulas?: Array<{
+        cell: string;
+        formula: string;
+    }>;
+    clipped?: string;
+}
+export interface PptRead {
+    slides: number;
+    width: number;
+    height: number;
+    items: Array<{
+        slide: number;
+        layout?: string;
+        shapes: Array<{
+            name: string;
+            type: string;
+            box: number[];
+            text?: string;
+        }>;
+    }>;
+}
+export interface EditResult {
+    done: string[];
+    total: number;
+    failed?: {
+        index: number;
+        op: string;
+        error: string;
+        code: string;
+    };
+}
+export declare function formatStatus(apps: AppStatus[]): string;
+export declare function formatOpened(doc: DocInfo): string;
+export declare function formatWord(read: WordRead): string;
+export declare function formatExcel(read: ExcelRead): string;
+export declare function formatPpt(read: PptRead): string;
+export declare function formatEdit(result: EditResult): string;

package/lib/types/helper-client.d.ts

@@ -0,0 +1,31 @@
+export interface HelperEvent {
+    event: string;
+    reason?: string;
+}
+export interface HelperLike {
+    call<T = unknown>(cmd: string, args?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    onEvent(listener: (event: HelperEvent) => void): () => void;
+    dispose(): void;
+}
+/** A file in helper/ at the package root: one level up from lib/ or src/, two from lib/types/. */
+export declare function helperAssetPath(name: string): string;
+export declare function helperSourcePath(): string;
+/** Compile the helper if this source version has no cached exe yet; returns the exe path. */
+export declare function ensureHelperExe(source?: string): Promise<string>;
+export declare class HelperClient implements HelperLike {
+    private readonly log;
+    private child;
+    private starting;
+    private readonly pending;
+    private readonly listeners;
+    private nextId;
+    private disposed;
+    constructor(log?: (message: string) => void);
+    onEvent(listener: (event: HelperEvent) => void): () => void;
+    call<T = unknown>(cmd: string, args?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    dispose(): void;
+    private kill;
+    private ensure;
+    private start;
+    private handle;
+}

package/lib/types/index.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export { DEFAULTS, ENTRY_ID, resolveConfig } from './settings.js';
+export declare const name = "@copylee/dsh-office";
+export declare const inject: string[];
+export declare const STATUS_ROUTE = "/api/dsh-office/status";
+export interface Config {
+    showOnOpen?: boolean;
+    renderWidth?: number;
+}
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/prompt.d.ts

@@ -0,0 +1,2 @@
+/** System-prompt section: when to reach for the office_ tools, in as few tokens as will do. */
+export declare function promptText(): string;

package/lib/types/settings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Plugin settings shared by the host and the settings page: defaults and the
+ * tolerant reader for the Loader entry config. No schemastery here so the
+ * browser bundle stays small.
+ */
+/** The Loader entry id (settings namespace); see cordis.patch.yml. */
+export declare const ENTRY_ID = "copylee-office";
+export interface Settings {
+    /** Bring the document's window to the front when office_open opens it. */
+    showOnOpen: boolean;
+    /** Width in pixels of the pictures office_render gives the model. */
+    renderWidth: number;
+}
+export declare const DEFAULTS: Settings;
+/** Unwrap `.volatile()` refs (`{ get() }`) and fall back to defaults for bad values. */
+export declare function resolveConfig(raw: unknown): Settings;

package/lib/types/tools.d.ts

@@ -0,0 +1,24 @@
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import { defineTool } from '@deepseek-ai/dsh-tools';
+import { type AppKind } from './format.js';
+import type { HelperLike } from './helper-client.js';
+import type { Settings } from './settings.js';
+type ToolDefinition = ReturnType<typeof defineTool>;
+export interface ToolHost {
+    helper: HelperLike;
+    settings(): Settings;
+    /** Persist a picture so the model can see it. */
+    saveImage(data: Buffer, name: string): Promise<ImageAttachmentRef>;
+    /** Whether the conversation model can look at images. */
+    vision(exec: unknown): Promise<boolean>;
+}
+interface Target {
+    app?: string;
+    doc?: string;
+}
+/** Which app a call is about: said outright, or told from the file name. */
+export declare function appOf(args: Target & {
+    path?: string;
+}): AppKind;
+export declare function createTools(host: ToolHost): ToolDefinition[];
+export {};

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "@copylee/dsh-office",
+  "version": "0.1.0",
+  "description": "DeepSeek Harness Office 插件（Windows）：AI 直接在你打开的 Word / Excel / PowerPoint 里改文档，改动实时出现在窗口中，你可以同时编辑；读结构、批量编辑、渲染成图核对、保存。",
+  "type": "module",
+  "author": "copylee",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/copylee711/dsh-office.git"
+  },
+  "bugs": {
+    "url": "https://github.com/copylee711/dsh-office/issues"
+  },
+  "homepage": "https://github.com/copylee711/dsh-office#readme",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "helper/OfficeHelper.cs",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "win32"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "engines": {
+      "dsh": ">=0.2.0-rc.2"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc && tsdown",
+    "prepare": "pnpm run build",
+    "test": "vitest run",
+    "pack:check": "pnpm pack --dry-run",
+    "smoke": "node scripts/office-smoke.mjs"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "ai-agent",
+    "office",
+    "word",
+    "excel",
+    "powerpoint",
+    "docx",
+    "xlsx",
+    "pptx",
+    "com-automation",
+    "windows",
+    "cordis"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.0 <5",
+    "@deepseek-ai/schemastery": ">=3.18.0 <4",
+    "react": ">=18.2.0 <19"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "@types/node": "^22.20.0",
+    "@types/react": "~18.3.31",
+    "react": "^18.3.1",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "packageManager": "pnpm@10.28.0",
+  "publishConfig": {
+    "access": "public"
+  }
+}