@modelprofile.com/flexharness 6.0.0 → 7.0.0

package/dist_ts_tools_node/tool.persistence.d.ts

@@ -0,0 +1,15 @@
+import type { IToolJobSnapshot, IToolJobStore, IToolJobState } from '@modelprofile.com/flexharness-agent';
+export interface IFileToolJobStoreOptions {
+    filePath: string;
+    lockTimeoutMs?: number;
+}
+export declare class FileToolJobStore implements IToolJobStore {
+    private readonly filePath;
+    private readonly lockTimeoutMs;
+    constructor(options: IFileToolJobStoreOptions);
+    private readSnapshot;
+    private withLock;
+    private writeAtomic;
+    load(abortSignal?: AbortSignal): Promise<IToolJobSnapshot | undefined>;
+    save(jobs: readonly IToolJobState[], expectedRevision: number, abortSignal?: AbortSignal): Promise<number>;
+}

package/dist_ts_tools_node/tool.persistence.js

@@ -0,0 +1,129 @@
+import * as plugins from './plugins.js';
+const decodeSnapshot = (value) => {
+    const snapshot = value;
+    if (!snapshot
+        || snapshot.schemaVersion !== plugins.JOB_SNAPSHOT_SCHEMA_VERSION
+        || !Number.isSafeInteger(snapshot.revision)
+        || (snapshot.revision ?? -1) < 1
+        || !Array.isArray(snapshot.jobs)) {
+        throw new Error('Invalid tool job snapshot.');
+    }
+    return snapshot;
+};
+const sleep = async (milliseconds) => {
+    await new Promise((resolve) => setTimeout(resolve, milliseconds));
+};
+export class FileToolJobStore {
+    filePath;
+    lockTimeoutMs;
+    constructor(options) {
+        if (!options.filePath.trim())
+            throw new Error('FileToolJobStore filePath must not be empty.');
+        this.filePath = plugins.path.resolve(options.filePath);
+        this.lockTimeoutMs = options.lockTimeoutMs ?? 10_000;
+        if (!Number.isSafeInteger(this.lockTimeoutMs) || this.lockTimeoutMs <= 0) {
+            throw new Error('lockTimeoutMs must be a positive integer.');
+        }
+    }
+    async readSnapshot() {
+        try {
+            return decodeSnapshot(plugins.v8.deserialize(await plugins.fs.promises.readFile(this.filePath)));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw error;
+        }
+    }
+    async withLock(operation, abortSignal) {
+        const lockPath = `${this.filePath}.lock`;
+        const ownerPath = plugins.path.join(lockPath, 'owner');
+        const ownerToken = plugins.crypto.randomUUID();
+        const ownerRecord = JSON.stringify({ token: ownerToken });
+        await plugins.fs.promises.mkdir(plugins.path.dirname(lockPath), { recursive: true });
+        const startedAt = Date.now();
+        while (true) {
+            abortSignal?.throwIfAborted();
+            try {
+                await plugins.fs.promises.mkdir(lockPath);
+                try {
+                    await plugins.fs.promises.writeFile(ownerPath, ownerRecord, 'utf8');
+                }
+                catch (error) {
+                    await plugins.fs.promises.rm(lockPath, { recursive: true, force: true });
+                    throw error;
+                }
+                break;
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST')
+                    throw error;
+                if (Date.now() - startedAt >= this.lockTimeoutMs) {
+                    throw new Error(`Timed out waiting for the tool job store lock at "${lockPath}".`);
+                }
+                await sleep(20);
+            }
+        }
+        try {
+            return await operation();
+        }
+        finally {
+            let stillOwner = false;
+            try {
+                const owner = JSON.parse(await plugins.fs.promises.readFile(ownerPath, 'utf8'));
+                stillOwner = owner.token === ownerToken;
+            }
+            catch { }
+            if (stillOwner) {
+                await plugins.fs.promises.rm(lockPath, { recursive: true, force: true });
+            }
+        }
+    }
+    async writeAtomic(snapshot, abortSignal) {
+        abortSignal?.throwIfAborted();
+        const directoryPath = plugins.path.dirname(this.filePath);
+        await plugins.fs.promises.mkdir(directoryPath, { recursive: true });
+        const temporaryPath = `${this.filePath}.${process.pid}.${plugins.crypto.randomUUID()}.tmp`;
+        let handle;
+        try {
+            handle = await plugins.fs.promises.open(temporaryPath, 'wx');
+            await handle.writeFile(plugins.v8.serialize(snapshot));
+            await handle.sync();
+            await handle.close();
+            handle = undefined;
+            abortSignal?.throwIfAborted();
+            await plugins.fs.promises.rename(temporaryPath, this.filePath);
+            const directoryHandle = await plugins.fs.promises.open(directoryPath, 'r');
+            try {
+                await directoryHandle.sync();
+            }
+            finally {
+                await directoryHandle.close();
+            }
+        }
+        finally {
+            if (handle)
+                await handle.close().catch(() => undefined);
+            await plugins.fs.promises.rm(temporaryPath, { force: true });
+        }
+    }
+    async load(abortSignal) {
+        abortSignal?.throwIfAborted();
+        const snapshot = await this.readSnapshot();
+        abortSignal?.throwIfAborted();
+        return snapshot;
+    }
+    async save(jobs, expectedRevision, abortSignal) {
+        return this.withLock(async () => {
+            abortSignal?.throwIfAborted();
+            const actualRevision = (await this.readSnapshot())?.revision ?? 0;
+            if (actualRevision !== expectedRevision) {
+                throw new plugins.ToolJobStoreConflictError(expectedRevision, actualRevision);
+            }
+            const revision = expectedRevision + 1;
+            await this.writeAtomic(plugins.createToolJobSnapshot(jobs, revision), abortSignal);
+            return revision;
+        }, abortSignal);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9vbC5wZXJzaXN0ZW5jZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX3Rvb2xzX25vZGUvdG9vbC5wZXJzaXN0ZW5jZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQVF4QyxNQUFNLGNBQWMsR0FBRyxDQUFDLEtBQWMsRUFBb0IsRUFBRTtJQUMxRCxNQUFNLFFBQVEsR0FBRyxLQUFrQyxDQUFDO0lBQ3BELElBQ0UsQ0FBQyxRQUFRO1dBQ04sUUFBUSxDQUFDLGFBQWEsS0FBSyxPQUFPLENBQUMsMkJBQTJCO1dBQzlELENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDO1dBQ3hDLENBQUMsUUFBUSxDQUFDLFFBQVEsSUFBSSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUM7V0FDN0IsQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsRUFDaEMsQ0FBQztRQUNELE1BQU0sSUFBSSxLQUFLLENBQUMsNEJBQTRCLENBQUMsQ0FBQztJQUNoRCxDQUFDO0lBQ0QsT0FBTyxRQUE0QixDQUFDO0FBQ3RDLENBQUMsQ0FBQztBQUVGLE1BQU0sS0FBSyxHQUFHLEtBQUssRUFBRSxZQUFvQixFQUFpQixFQUFFO0lBQzFELE1BQU0sSUFBSSxPQUFPLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxPQUFPLEVBQUUsWUFBWSxDQUFDLENBQUMsQ0FBQztBQUNwRSxDQUFDLENBQUM7QUFFRixNQUFNLE9BQU8sZ0JBQWdCO0lBQ1YsUUFBUSxDQUFTO0lBQ2pCLGFBQWEsQ0FBUztJQUV2QyxZQUFZLE9BQWlDO1FBQzNDLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLElBQUksRUFBRTtZQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsOENBQThDLENBQUMsQ0FBQztRQUM5RixJQUFJLENBQUMsUUFBUSxHQUFH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

package/dist_ts_tools_node/tools.local.d.ts

@@ -0,0 +1,11 @@
+import * as plugins from './plugins.js';
+export interface IFilesystemToolOptions extends plugins.ICreateFilesystemToolsOptions {
+    rootDir?: string;
+    context?: plugins.IToolExecutionContext;
+}
+export interface IShellToolOptions extends plugins.ICreateShellToolsOptions {
+    cwd?: string;
+    context?: plugins.IToolExecutionContext;
+}
+export declare function filesystemTool(options?: IFilesystemToolOptions): plugins.ToolSet;
+export declare function shellTool(options?: IShellToolOptions): plugins.ToolSet;

package/dist_ts_tools_node/tools.local.js

@@ -0,0 +1,15 @@
+import * as plugins from './plugins.js';
+import { createLocalToolExecutionContext } from './tool.context.js';
+export function filesystemTool(options) {
+    const context = options?.context ?? createLocalToolExecutionContext({ rootDir: options?.rootDir });
+    return plugins.createFilesystemTools(context, options);
+}
+export function shellTool(options) {
+    const context = options?.context ?? createLocalToolExecutionContext({ cwd: options?.cwd });
+    return plugins.createShellTools(context, {
+        ...options,
+        // An internally created context has no caller-visible background-job owner.
+        includeBackground: options?.context ? true : false,
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidG9vbHMubG9jYWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c190b29sc19ub2RlL3Rvb2xzLmxvY2FsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSwrQkFBK0IsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBWXBFLE1BQU0sVUFBVSxjQUFjLENBQUMsT0FBZ0M7SUFDN0QsTUFBTSxPQUFPLEdBQUcsT0FBTyxFQUFFLE9BQU8sSUFBSSwrQkFBK0IsQ0FBQyxFQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxFQUFFLENBQUMsQ0FBQztJQUNuRyxPQUFPLE9BQU8sQ0FBQyxxQkFBcUIsQ0FBQyxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFDekQsQ0FBQztBQUVELE1BQU0sVUFBVSxTQUFTLENBQUMsT0FBMkI7SUFDbkQsTUFBTSxPQUFPLEdBQUcsT0FBTyxFQUFFLE9BQU8sSUFBSSwrQkFBK0IsQ0FBQyxFQUFFLEdBQUcsRUFBRSxPQUFPLEVBQUUsR0FBRyxFQUFFLENBQUMsQ0FBQztJQUMzRixPQUFPLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxPQUFPLEVBQUU7UUFDdkMsR0FBRyxPQUFPO1FBQ1YsNEVBQTRFO1FBQzVFLGlCQUFpQixFQUFFLE9BQU8sRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsS0FBSztLQUNuRCxDQUFDLENBQUM7QUFDTCxDQUFDIn0=

package/package.json

@@ -2,9 +2,9 @@
   "author": "Task Venture Capital GmbH",
   "license": "MIT",
   "name": "@modelprofile.com/flexharness",
-  "version": "6.0.0",
+  "version": "7.0.0",
   "type": "module",
-  "description": "Managed multi-scope agent harness with permissions, public projections and persistence coordination.",
+  "description": "Managed agent sessions with tools, MCP, chat, OCR, documents and browser control through focused subpath imports.",
   "main": "./dist_ts/index.js",
   "types": "./dist_ts/index.d.ts",
   "exports": {
@@ -15,20 +15,128 @@
     "./migration": {
       "types": "./dist_ts_migration/index.d.ts",
       "import": "./dist_ts_migration/index.js"
+    },
+    "./tools": {
+      "types": "./dist_ts_tools/index.d.ts",
+      "import": "./dist_ts_tools/index.js"
+    },
+    "./tools/node": {
+      "types": "./dist_ts_tools_node/index.d.ts",
+      "import": "./dist_ts_tools_node/index.js"
+    },
+    "./compaction": {
+      "types": "./dist_ts_compaction/index.d.ts",
+      "import": "./dist_ts_compaction/index.js"
+    },
+    "./mcp": {
+      "types": "./dist_ts_mcp/index.d.ts",
+      "import": "./dist_ts_mcp/index.js"
+    },
+    "./media": {
+      "types": "./dist_ts_media/index.d.ts",
+      "import": "./dist_ts_media/index.js"
+    },
+    "./documents": {
+      "types": "./dist_ts_document/index.d.ts",
+      "import": "./dist_ts_document/index.js"
+    },
+    "./ocr": {
+      "types": "./dist_ts_ocr/index.d.ts",
+      "import": "./dist_ts_ocr/index.js"
+    },
+    "./kvm": {
+      "types": "./dist_ts_kvm/index.d.ts",
+      "import": "./dist_ts_kvm/index.js"
+    },
+    "./chat": {
+      "types": "./dist_ts_chat/index.d.ts",
+      "import": "./dist_ts_chat/index.js"
+    },
+    "./chat/cli": {
+      "types": "./dist_ts_chat_cli/index.d.ts",
+      "import": "./dist_ts_chat_cli/index.js"
+    },
+    "./chat/web": {
+      "types": "./dist_ts_chat_web/index.d.ts",
+      "import": "./dist_ts_chat_web/index.js"
     }
   },
   "dependencies": {
-    "@modelprofile.com/flexharness-agent": "6.0.0"
+    "@modelprofile.com/flexharness-agent": "7.0.0",
+    "@modelprofile.com/flexharness-models": "7.0.0",
+    "@push.rocks/smartrequest": "^5.0.1",
+    "ai": "^7.0.79",
+    "zod": "^4.4.1"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@push.rocks/smartpdf": "^5.0.1",
+    "puppeteer": "^24.42.0",
+    "ink": "^6.8.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.2.5",
+    "lit": "^3.2.0",
+    "@types/react": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "@push.rocks/smartpdf": {
+      "optional": true
+    },
+    "puppeteer": {
+      "optional": true
+    },
+    "ink": {
+      "optional": true
+    },
+    "ink-text-input": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "lit": {
+      "optional": true
+    },
+    "@types/react": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=24"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist_ts_chat_web/**/*.js"
+  ],
   "files": [
     "ts",
     "dist_ts",
     "ts_migration",
     "dist_ts_migration",
+    "ts_tools",
+    "dist_ts_tools",
+    "ts_tools_node",
+    "dist_ts_tools_node",
+    "ts_compaction",
+    "dist_ts_compaction",
+    "ts_mcp",
+    "dist_ts_mcp",
+    "ts_media",
+    "dist_ts_media",
+    "ts_document",
+    "dist_ts_document",
+    "ts_ocr",
+    "dist_ts_ocr",
+    "ts_kvm",
+    "dist_ts_kvm",
+    "ts_chat",
+    "dist_ts_chat",
+    "ts_chat_cli",
+    "dist_ts_chat_cli",
+    "ts_chat_web",
+    "dist_ts_chat_web",
     "readme.md",
     "license.md"
   ]

package/readme.md

@@ -1,98 +1,154 @@
-FlexHarness is a modular toolbox for model inference, standalone agents, managed sessions, tools and provider capabilities. It brings SmartAI and SmartAgent into one repository while publishing independently installable packages through tspublish.
+FlexHarness is a modular toolbox for model inference, agents, managed sessions, chat, OCR, KVM control and provider capabilities. It brings SmartAI, SmartAgent, SmartChat, SmartKVM and SmartOCR's AI helpers into one repository through four focused packages published with tspublish.
 
 ## Issue Reporting and Security
 
 For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
 
-## Choose components
+## Install and choose an entrypoint
 
-All package names below use the `@modelprofile.com/` scope. Components share a release version; each published package declares only its own dependencies. The private repository root is a development dependency catalog, not an install-everything package.
+The toolbox publishes **four packages** under `@modelprofile.com`, with one shared
+release version. Integrations use subpath imports instead of additional package
+names.
 
-| Package | Responsibility |
+| Package | Use it for |
 | --- | --- |
-| `flexharness-models` | Model contracts, explicit `ModelRegistry`, AI SDK helpers and prompt caching |
-| `flexharness-provider-{anthropic,openai,google,groq,mistral,xai,perplexity,ollama}` | One explicitly selected model provider per package |
-| `flexharness-agent` | `runAgent`, `AgentSession`, canonical events, generation transactions and tool contracts |
-| `flexharness` | Managed scopes, sessions, permissions, public projections and persistence coordination |
-| `flexharness-tools` | Tool factories using a host-supplied execution context, HTTP and JSON tools |
-| `flexharness-tools-node` | Local filesystem/process contexts, `filesystemTool`, `shellTool` and file-backed job stores |
-| `flexharness-compaction` | Model-driven conversation compaction |
-| `flexharness-mcp` | MCP clients and AI SDK tool conversion |
-| `flexharness-openai-auth` | ChatGPT device/browser authentication, refresh and model connections |
-| `flexharness-openai-account` | Account lifecycle, model catalog, rate limits and credential envelopes |
-| `flexharness-openai-auth-files` | Explicit interoperability with existing external credential files |
-| `flexharness-media` | Vision recipes for an injected model |
-| `flexharness-media-openai` | OpenAI audio and image capabilities |
-| `flexharness-document` | PDF processing; this component alone brings SmartPDF |
-| `flexharness-ocr` | OCR contracts with an injected transport; no runtime dependencies |
-| `flexharness-research` | Anthropic research capabilities |
-
-For model inference without an agent:
+| `flexharness` | Managed sessions, permissions, tools, chat, OCR, documents and KVM |
+| `flexharness-agent` | Standalone `runAgent` and `AgentSession`; portable `/runner` |
+| `flexharness-models` | Model contracts, `ModelRegistry`, AI SDK helpers and caching |
+| `flexharness-providers` | All eight model providers, authentication, accounts, media and research |
+
+For a managed agent with model providers:
+
+```sh
+pnpm add @modelprofile.com/flexharness @modelprofile.com/flexharness-providers
+```
+
+For inference without an agent:
 
 ```sh
-pnpm add @modelprofile.com/flexharness-models @modelprofile.com/flexharness-provider-openai
+pnpm add @modelprofile.com/flexharness-models @modelprofile.com/flexharness-providers
 ```
 
 ```typescript
 import { ModelRegistry, generateText } from '@modelprofile.com/flexharness-models';
-import { createOpenAiModelProvider } from '@modelprofile.com/flexharness-provider-openai';
+import { createOpenAiModelProvider } from '@modelprofile.com/flexharness-providers/openai';
 
 const models = new ModelRegistry().register(createOpenAiModelProvider());
 const setup = models.getModelSetup({
-  provider: 'openai',
-  model: 'gpt-5.5',
-  apiKey: process.env.OPENAI_API_KEY,
+  provider: 'openai', model: 'gpt-5.5', apiKey: process.env.OPENAI_API_KEY,
 });
 const result = await generateText({ ...setup, prompt: 'Hello' });
 ```
 
-For a standalone agent, add `@modelprofile.com/flexharness-agent` and pass the same model setup to `runAgent({ ...setup, prompt: 'Hello' })`. Providers are registered on caller-owned registries; duplicate IDs and unknown providers fail explicitly. Importing a provider, agent or harness does not register anything globally.
+For a standalone agent, install `@modelprofile.com/flexharness-agent` and pass the
+same setup to `runAgent({ ...setup, prompt: 'Hello' })`. Node.js 24 or newer is
+required for Node entrypoints. Each application owns its model registry; imports
+do not register providers globally.
+
+## Harness subpaths
+
+All entries below belong to `@modelprofile.com/flexharness`. The root export stays
+focused on managed sessions. Importing it does not load UI, PDF, browser automation
+or provider SDKs.
+
+| Import suffix | Capability | Additional install |
+| --- | --- | --- |
+| `/tools` | Host-supplied execution contexts, HTTP and JSON tools | None |
+| `/tools/node` | Local filesystem and process tools, file-backed job adapters | None |
+| `/compaction` | Model-driven conversation compaction | None |
+| `/media` | Vision recipes using an injected model | None |
+| `/ocr` | `ImageOcr`, OCR contracts and Mistral transport | None |
+| `/chat` | Portable streaming `ChatSession`, history and usage | None |
+| `/chat/cli` | Ink/React terminal chat | `ink ink-text-input react`; TypeScript: `@types/react` |
+| `/chat/web` | Lit `flexchat-window`, `flexchat-message`, `flexchat-input` | `lit` |
+| `/kvm` | Browser control, terminal framing and OCR observation | `puppeteer` |
+| `/documents` | PDF processing and `extractTextFromPdf` | `@push.rocks/smartpdf` |
+| `/mcp` | MCP clients and AI SDK tool conversion | `@modelcontextprotocol/sdk` |
+| `/migration` | Existing versioned harness migrations | None |
+
+The integrations in the last column use optional peer dependencies. Install them
+only for the entrypoints your project imports, for example:
 
-For OpenAI ChatGPT authentication, add `flexharness-openai-auth` and set `connection: createOpenAiChatGptModelConnection(credentials)` in the OpenAI model options. This connection supplies the existing authentication settings and system-instruction middleware. API-key inference does not depend on the authentication or account packages.
-
-## Install the managed harness
-
-```bash
-pnpm add @modelprofile.com/flexharness
+```sh
+pnpm add @modelprofile.com/flexharness lit
 ```
 
-Node.js 24 or newer is required.
-
-## Overview
+```typescript
+import { ChatSession } from '@modelprofile.com/flexharness/chat';
+import '@modelprofile.com/flexharness/chat/web';
+```
 
-FlexHarness owns scope isolation, public session and message projections, permission decisions, event delivery, cancellation, and persistence coordination. Each session is backed by the `flexharness-agent` component's `AgentSession`, which owns the canonical private conversation and runtime event history. Model selection, tool execution, and optional execution-context creation remain application-defined extension points. The managed harness depends on the standalone agent; it does not install provider SDKs, MCP, document processing or local execution tools.
+Chat uses the portable `flexharness-agent/runner`. A browser application can provide
+a model backed by its own server transport, or supply `run` in
+`IChatSessionOptions`. The web element accepts an `IChatSession` and maintains its
+own subscription. Full Node `AgentSession` remains at the agent package root.
 
-## Migrating from SmartAI and SmartAgent
+## Provider subpaths
 
-Update all related imports together and install the components they reference. The old packages are superseded; their published versions remain available so existing installations can be migrated deliberately.
+Install `@modelprofile.com/flexharness-providers` once. Its root exports all provider
+factories; use a provider subpath to import just that implementation.
 
-| Previous import/API | Replacement |
+| Import suffix | Capability |
 | --- | --- |
-| `@push.rocks/smartai` model/cache/AI SDK contracts | `@modelprofile.com/flexharness-models` |
-| Global `getModel` / `getModelSetup` | A `ModelRegistry` with explicit provider registrations |
-| Provider-specific request types | The relevant `flexharness-provider-*` package |
-| `openAiChatGptAuth` model option | `connection: createOpenAiChatGptModelConnection(credentials)` from `flexharness-openai-auth` |
-| SmartAI root authentication functions/types | `flexharness-openai-auth` |
-| `@push.rocks/smartai/providers` | `flexharness-openai-account` |
-| `@push.rocks/smartai/openai-chatgpt-auth` | `flexharness-openai-auth-files` |
-| SmartAI `/vision`, `/audio`, `/image` | `flexharness-media`, `flexharness-media-openai`, `flexharness-media-openai` |
-| SmartAI `/document`, `/ocr`, `/research` | `flexharness-document`, `flexharness-ocr`, `flexharness-research` |
-| `@push.rocks/smartagent` agent/event/persistence/adapter contracts | `flexharness-agent` |
-| SmartAgent `/tools` factories and output formatting | `flexharness-tools` |
-| Local contexts, `filesystemTool`, `shellTool`, `FileToolJobStore` | `flexharness-tools-node` |
-| SmartAgent `/compaction`, `/mcp` | `flexharness-compaction`, `flexharness-mcp` |
-
-Existing `ISmartAi*` and `TSmartAi*` contract names remain where their semantics are unchanged. The models package accepts provider IDs as strings; applications that expose a fixed set of providers should own that narrower union. The OpenAI account registry remains `SmartAiProviderRegistry`; it manages account adapters and is distinct from inference's `ModelRegistry`.
-
-Durable Agent event/job schemas, FlexHarness projection schemas, credential envelopes, and external credential-source names and paths are preserved. The package move does not require a data migration. Existing FlexHarness versioned migration APIs remain at `@modelprofile.com/flexharness/migration`.
-
-## Developing and releasing the toolbox
-
-Each `ts_*` component has a `tspublish.json` declaring its dependencies, owned folders and published exports. Cross-component source imports use package names. TypeScript mappings provide source entrypoints for tsrun and declaration entrypoints for tsbuild's compiled-folder resolution; no workspace links are required.
-
-`pnpm build` builds the components in declared dependency order. `pnpm test` runs the deterministic model, agent and harness regressions. Live provider tests and the browser authentication smoke test are preserved in `test_integration/` and run only when explicitly selected; they are not part of release preflight.
-
-GitZone's `release.targets.npm.packageSource: "tspublish"` prepares and packs every component once, publishes the dependency order to the configured registries, and records the exact artifacts in its release journal. A partial release resumes those stored artifacts. Third-party OpenAI Codex notices accompany the authentication and account packages.
+| `/anthropic`, `/openai`, `/google`, `/groq`, `/mistral`, `/xai`, `/perplexity`, `/ollama` | Model adapters and their request types |
+| `/auth` | ChatGPT browser/device authentication, refresh and model connections |
+| `/accounts` | Account lifecycle, model catalogs, rate limits and credential envelopes |
+| `/auth/files` | Explicit interoperability with external credential files |
+| `/media` | OpenAI audio and image generation |
+| `/research` | Anthropic research utilities |
+
+Provider SDKs are installed together. Authentication, file access and vendor media
+are separate entrypoints and are not imported by the provider factory root. For
+ChatGPT authentication, pass
+`connection: createOpenAiChatGptModelConnection(credentials)` from `/auth` to the
+OpenAI model options. API-key inference needs no authentication setup.
+
+## Migration
+
+Replace the withdrawn 6.x component imports with the subpaths above. Provider
+imports change from individual provider packages to
+`@modelprofile.com/flexharness-providers/<provider>`. Keep direct agent and models
+imports and upgrade them to the same release version. The removed package names
+are not republished.
+
+| Previous API | Replacement |
+| --- | --- |
+| SmartAI models, caching and AI SDK contracts | `flexharness-models` and explicit `ModelRegistry` registrations |
+| SmartAI provider factories | `flexharness-providers/<provider>` |
+| SmartAI authentication, account adapters and external credential files | `flexharness-providers/auth`, `/accounts`, `/auth/files` |
+| SmartAI vision, document and OCR helpers | `flexharness/media`, `/documents`, `/ocr` |
+| SmartAI audio, image and research helpers | `flexharness-providers/media`, `/research` |
+| SmartAgent runtime, events and persistence contracts | `flexharness-agent` |
+| SmartAgent tools, local tools, compaction and MCP | `flexharness/tools`, `/tools/node`, `/compaction`, `/mcp` |
+| SmartChat sessions, CLI and web components | `flexharness/chat`, `/chat/cli`, `/chat/web` |
+| SmartKVM | `flexharness/kvm`: `BrowserKvm`, `KvmTerminal`, `createKvmTools` |
+| SmartOCR image AI helper | `ImageOcr.recognizeImageBytes` from `flexharness/ocr` |
+| SmartOCR PDF AI helper | `extractTextFromPdf` from `flexharness/documents` |
+
+For image OCR, rename `smartAiOcrEngine` to `engine` and `mistralOcrOptions` to
+`mistralOptions`; pass the API key explicitly. Native searchable-PDF processing
+through `SmartOcr.processPdfBuffer` remains in SmartOCR.
+
+Existing `ISmartAi*` and `TSmartAi*` contracts, durable event/job schemas, harness
+projections, credential envelopes and external credential paths remain unchanged.
+The OpenAI account `SmartAiProviderRegistry` is separate from inference's
+`ModelRegistry`. The package consolidation requires no data migration.
+
+## Developing and releasing
+
+Four named `tspublish.json` descriptors own the published packages. Other folder
+descriptors specify compilation order only. Each package explicitly declares its
+owned folders, exports and required or optional peer dependencies. Source and
+compiled declaration mappings support development without workspace links.
+
+Run `pnpm build`, `pnpm test` and `pnpm run check:test`. Tests install packed
+artifacts in disposable directories to check minimal dependency graphs, every
+public subpath and browser imports. Live provider and browser authentication tests
+remain opt-in in `test_integration/`.
+
+The configured GitZone release prepares four packages, records their exact
+artifacts, and publishes models before its dependents to npmjs and Verdaccio.
+Third-party OpenAI Codex notices accompany the providers package.
 
 ## Core Setup
 

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@modelprofile.com/flexharness',
-  version: '6.0.0',
+  version: '7.0.0',
   description: 'The FlexHarness toolbox source repository and shared dependency catalog.'
 }