@womp/spark-agent 5.5.0 → 5.6.1

package/README.md

@@ -395,7 +395,9 @@ yarn web:build
 
 ## Release procedure
 
-Releases use a manual package publication; no separate release service is required.
+Pushes to `main` run `.github/workflows/publish.yml`. Publication is driven by
+`package.json`, not Git tags: already-published versions skip; unpublished stable versions
+newer than npm's `latest` run release checks and publish automatically.
 
 Versions follow **MAJOR.MINOR.PATCH** (for example, `4.4.0`):
 
@@ -405,22 +407,19 @@ Versions follow **MAJOR.MINOR.PATCH** (for example, `4.4.0`):
 
 ### Publishing
 
-1. Choose an unused package version after checking `npm view @womp/spark-agent versions --json`.
-   Update `package.json` and record public API changes and migration notes. Use a new minor version
-   for incompatible changes while the package is below 1.0.
-2. On a supported Node version, run `yarn install --frozen-lockfile`, `yarn typecheck`, `yarn test`,
-   and `yarn web:build`. Do not bypass dependency engine checks. Commit the release changes and
-   record the commit used to build the package.
-3. Run `yarn pack --filename spark-agent-release.tgz`. Inspect the archive contents and install
-   that archive in the consuming application. Verify packaged declarations and skills, browser
-   import boundaries, the production build, and the applicable integration cases without source
-   aliases. Keep the archive outside Git and do not rebuild or change it after verification.
-4. Publish the verified archive with `npm publish ./spark-agent-release.tgz --access public`.
-   If the response is uncertain, inspect the registry's version and integrity before retrying.
-   Verify the published version and archive integrity, then tag the recorded commit as `v<version>`
-   and push the release commit and tag. An already published version cannot be replaced; corrections
-   need a new version.
-5. In the consuming application, use `yarn add @womp/spark-agent@<version> --exact`. Commit its
+1. Configure npm's trusted publisher once for `@womp/spark-agent`: organization `wompxyz`,
+   repository `spark-agent`, workflow filename `publish.yml`, no environment, and allow direct
+   `npm publish`. GitHub-hosted runners use OIDC; no publishing token is required.
+2. Deliberately bump `package.json` to an unused stable MAJOR.MINOR.PATCH version and push
+   the release commit to `main`. Prereleases/build metadata are not published by this workflow.
+3. CI installs the frozen Yarn lockfile, runs typechecks, tests and the UI build, then checks
+   package entry files and imports every exported module from a fresh tarball installation.
+   It rechecks npm before publishing that same archive and verifies registry integrity and `latest`.
+   Releases are serialized; newer pending pushes may supersede older pending runs.
+   Registry failures stop publication rather than being treated as missing versions.
+4. If publication reports an uncertain result, inspect npm before rerunning the failed workflow.
+   Published versions cannot be replaced; corrections need a new version. No tags are required.
+5. In the consuming application, use `yarn add @womp/spark-agent@<version> --exact`. Commit its
    manifest and lockfile together, and verify a clean frozen-lockfile installation and production
    build. Remove the temporary archive dependency. Application deployment and merge requirements
    remain separate from package publication.

package/dist/agent-tools.js

@@ -79,11 +79,10 @@ export function createSparkTools(options) {
     return {
         read_skill: tool({
             ...inputLabels("name"),
-            description: "Read required skills together with names, or one skill with name. Returns instructions, TypeScript API declarations, and JavaScript examples from the available directory.",
-            inputSchema: z.union([
-                z.object({ names: z.array(z.string().min(1).max(160)).min(1) }).strict(),
-                z.object({ name: z.string().min(1).max(160) }).strict(),
-            ]),
+            description: "Read the skills listed in names. Returns instructions, TypeScript API declarations, and JavaScript examples from the available directory.",
+            inputSchema: z.object({
+                names: z.array(z.string().min(1).max(160)).min(1),
+            }).strict(),
             execute: (input, { toolCallId }) => execute({ id: toolCallId, name: "read_skill", input }, async () => {
                 const read = (requested) => {
                     const skill = options.capabilities.skills.find(({ name }) => name === requested);
@@ -96,8 +95,6 @@ export function createSparkTools(options) {
                     }
                     return { ok: true, ...skill };
                 };
-                if ("name" in input)
-                    return read(input.name);
                 const skills = [...new Set(input.names)].map(read);
                 return { ok: skills.every(skill => skill.ok), skills };
             }),

package/dist/ui.d.ts

@@ -115,13 +115,9 @@ export type SparkUITools = {
     };
     read_skill: {
         input: {
-            name: string;
-            names?: never;
-        } | {
             names: string[];
-            name?: never;
         };
-        output: SkillReadResult | {
+        output: {
             ok: boolean;
             skills: SkillReadResult[];
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@womp/spark-agent",
-  "version": "5.5.0",
+  "version": "5.6.1",
   "description": "Portable skills-based AI agent with local and durable chat transports for Womp",
   "type": "module",
   "main": "./dist/index.js",
@@ -102,7 +102,8 @@
     "web:build": "yarn build && tsc --noEmit -p web/tsconfig.json && vite build --config web/vite.config.ts",
     "test": "yarn build && tsx --tsconfig tsconfig.json --test test/**/*.test.ts && node --input-type=module -e \"await Promise.all([import('@womp/spark-agent'), import('@womp/spark-agent/ui'), import('@womp/spark-agent/client'), import('@womp/spark-agent/server'), import('@womp/spark-agent/express'), import('@womp/spark-agent/kakapo'), import('@womp/spark-agent/geometry'), import('@womp/spark-agent/openscad')])\"",
     "test:live": "tsx --tsconfig tsconfig.json test/womp-scene-api.live.ts",
-    "prepack": "yarn build"
+    "prepack": "yarn build",
+    "release:pack": "node scripts/npm-release.mjs pack"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "4.0.50",

package/dist/sdk-openscad-renderer.d.ts

@@ -1,11 +0,0 @@
-import type { KakapoAPI } from "@womp/kakapo-sdk";
-import type { OpenScadBoundingBox } from "./openscad.js";
-export declare function waitForOpenScadRenderer(options: {
-    api: KakapoAPI;
-    objectId: number;
-    expectedBounds: OpenScadBoundingBox;
-    baselineBounds?: OpenScadBoundingBox;
-    signal: AbortSignal;
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-}): Promise<boolean>;

package/dist/sdk-openscad-renderer.js

@@ -1,71 +0,0 @@
-const OPENSCAD_RENDERER_WAIT_MS = 15_000;
-const OPENSCAD_RENDERER_POLL_MS = 250;
-function boundsMatch(actual, expected) {
-    const size = Math.max(expected.max.x - expected.min.x, expected.max.y - expected.min.y, expected.max.z - expected.min.z);
-    const tolerance = Math.max(size * 0.0001, 0.001);
-    return ["min", "max"].every((edge) => ["x", "y", "z"].every((axis) => Math.abs(actual[edge][axis] - expected[edge][axis]) <= tolerance));
-}
-function getBoundsBeforeDeadline(options) {
-    const remaining = options.deadline - Date.now();
-    if (remaining <= 0)
-        return Promise.resolve(undefined);
-    options.signal.throwIfAborted();
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        const finish = (action) => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timeout);
-            options.signal.removeEventListener("abort", onAbort);
-            action();
-        };
-        const onAbort = () => finish(() => reject(options.signal.reason ?? new Error("The operation was aborted.")));
-        const timeout = setTimeout(() => finish(() => resolve(undefined)), remaining);
-        options.signal.addEventListener("abort", onAbort, { once: true });
-        if (options.signal.aborted) {
-            onAbort();
-            return;
-        }
-        void options.api.getNodeBoundingBox(options.objectId).then((bounds) => finish(() => resolve(bounds)), () => finish(() => resolve(undefined)));
-    });
-}
-function waitForPoll(signal, milliseconds) {
-    signal.throwIfAborted();
-    return new Promise((resolve, reject) => {
-        const onAbort = () => {
-            clearTimeout(timeout);
-            reject(signal.reason ?? new Error("The operation was aborted."));
-        };
-        const timeout = setTimeout(() => {
-            signal.removeEventListener("abort", onAbort);
-            resolve();
-        }, milliseconds);
-        signal.addEventListener("abort", onAbort, { once: true });
-        if (signal.aborted)
-            onAbort();
-    });
-}
-export async function waitForOpenScadRenderer(options) {
-    const deadline = Date.now() + (options.timeoutMs ?? OPENSCAD_RENDERER_WAIT_MS);
-    if (options.baselineBounds !== undefined &&
-        boundsMatch(options.baselineBounds, options.expectedBounds))
-        return false;
-    do {
-        const actual = await getBoundsBeforeDeadline({
-            api: options.api,
-            objectId: options.objectId,
-            signal: options.signal,
-            deadline,
-        });
-        options.signal.throwIfAborted();
-        if (Date.now() >= deadline)
-            return false;
-        if (actual !== undefined && boundsMatch(actual, options.expectedBounds))
-            return true;
-        const remaining = deadline - Date.now();
-        if (remaining <= 0)
-            return false;
-        await waitForPoll(options.signal, Math.min(options.pollIntervalMs ?? OPENSCAD_RENDERER_POLL_MS, remaining));
-    } while (true);
-}