toolfactory 0.1.1

package/dist/surfaces/openclaw-native.d.ts

@@ -0,0 +1,93 @@
+import { type Project, type Surface } from "../model.js";
+import { type Registration } from "../report/coverage.js";
+/** Transcribed from `openclaw plugins init --type tool`; `validate()` proves them still current. */
+export declare const OPENCLAW_SCAFFOLD: {
+    /** The OpenClaw release the scaffold was taken from (`package.json openclaw.build`). */
+    readonly openclawVersion: "2026.9.2";
+    /** `peerDependencies.openclaw` and `openclaw.compat.pluginApi`. */
+    readonly pluginApi: ">=2026.5.17";
+    readonly private: true;
+    readonly scripts: {
+        readonly build: "tsc -p tsconfig.json";
+        readonly "plugin:build": "npm run build && openclaw plugins build --entry ./dist/index.js";
+        readonly "plugin:validate": "npm run build && openclaw plugins validate --entry ./dist/index.js";
+        readonly test: "vitest run --config ./vitest.config.ts";
+    };
+    readonly files: readonly ["dist", "openclaw.plugin.json", "README.md"];
+    readonly dependencies: {
+        readonly typebox: "^1.1.38";
+    };
+    readonly devDependencies: {
+        readonly openclaw: "latest";
+        readonly typescript: "^5.9.0";
+        readonly vitest: "^3.2.0";
+    };
+    readonly tsconfig: {
+        readonly compilerOptions: {
+            readonly target: "ES2022";
+            readonly module: "NodeNext";
+            readonly moduleResolution: "NodeNext";
+            readonly strict: true;
+            readonly declaration: true;
+            readonly outDir: "dist";
+            readonly skipLibCheck: true;
+        };
+        readonly include: readonly ["src/**/*.ts"];
+    };
+    readonly vitestConfig: "import { defineConfig } from \"vitest/config\";\n\nexport default defineConfig({\n  test: {\n    environment: \"node\",\n    include: [\"src/**/*.test.ts\"],\n  },\n});\n";
+    /** Entry module, relative to the plugin root, as `openclaw.extensions` records it. */
+    readonly entry: "./dist/index.js";
+    readonly sdkModule: "openclaw/plugin-sdk/tool-plugin";
+    /** `resolveStateDir()`: the directory OpenClaw keeps its own state in. */
+    readonly statePathsModule: "openclaw/plugin-sdk/state-paths";
+    /** Where `OpenClawPluginApi` and every registrar's parameter type come from. */
+    readonly entryModule: "openclaw/plugin-sdk/plugin-entry";
+    /** `pluginInspector` in package.json, as `--type provider` writes it. */
+    readonly inspector: {
+        readonly version: 1;
+        readonly priority: "high";
+        readonly seams: readonly ["plugin-runtime"];
+        readonly sourceRoot: ".";
+    };
+};
+/**
+ * toolfactory's additions over the upstream scaffold. Each is a key `openclaw plugins init` does
+ * not write, which is why the drift check (`src/hosts/openclaw.ts`) requires every scaffold key to
+ * survive into the projection but allows extra ones: upstream stays the source of truth for
+ * everything it does write.
+ */
+export declare const OPENCLAW_ADDITIONS: {
+    /** Without it `tsc` emits a `dist/` from source that failed type-checking. */
+    readonly compilerOptions: {
+        readonly noEmitOnError: true;
+    };
+    /** The scripted-model end-to-end lane; OpenClaw's own QA lane drives OpenClaw through aimock. */
+    readonly aimock: "^1.39.0";
+    readonly e2eScript: "npm run build && vitest run --config ./vitest.e2e.config.ts";
+    /**
+     * OpenClaw's install-time safety scan rejects a `node_modules` symlink whose target is outside
+     * the install root (`src/plugins/install-security-scan.runtime.ts`), which is exactly what npm
+     * makes of the `file:../..` core dependency. `install-links` materialises it as a real directory.
+     */
+    readonly npmrc: "# OpenClaw's install-time safety scan refuses a node_modules symlink pointing outside the\n# install root, which is what npm makes of a file: dependency. Materialise it instead.\ninstall-links=true\n";
+    /** The scripted model the e2e fixtures answer as; any id works, nothing resolves it upstream. */
+    readonly model: "openai/gpt-5.6-luna";
+};
+export declare const HOST_DIR = "hosts/openclaw";
+/** The region of `src/index.ts` toolfactory owns; the tail below the end marker is the author's. */
+export declare const ENTRY_BEGIN = "// tf:entry";
+export declare const ENTRY_END = "// /tf:entry";
+/** `titleFromId` from OpenClaw's scaffold generator. */
+export declare function displayName(id: string): string;
+/** Host registrations the plugin declares beyond tools. */
+export declare function registrations(project: Project): Registration[];
+/** `activation` for both the entry and the manifest; OpenClaw's own default is startup. */
+export declare function activation(project: Project): Record<string, unknown>;
+/**
+ * OpenClaw stores `normalizeJsonSchema(schema)` in the plugin manifest, so emit schemas that are
+ * already in that shape and `openclaw plugins build --check` stays a byte-for-byte agreement.
+ */
+export declare function normalizeSchema(value: unknown): unknown;
+/** The plugin's `configSchema`: the tool's own config schema, or OpenClaw's empty default. */
+export declare function configSchema(project: Project): Record<string, unknown>;
+export declare const surface: Surface;