openwork-models

# OpenWork Models Use this skill for OpenWork inference model changes. The source of truth for available upstream models is: - `ee/apps/gateway/src/models/base.json` - provider key: `openrouter` - model map: `openrouter.models` The editable OpenWork model list is: - `ee/apps/gateway/src/models/openwork-models.json` Managed file: - `packages/types/src/den/inference.ts` `ee/apps/gateway/scripts/build-models.mjs` reads `openwork-models.json` and generates the OpenWork provider overlay in memory. It selects the API URL from `OPENWORK_DEV_MODE`: dev uses `http://127.0.0.1:8791/api/v1`, otherwise prod uses `https://inference.openworklabs.com/api/v1`. Do not inspect the full `base.json` in chat. Use the scripts so the large source model body stays out of context. ## Scripts Extract/search source models into a temp file: ```bash node .opencode/skills/openwork-models/scripts/extract-source-models.mjs node .opencode/skills/openwork-models/scripts/extract-source-models.mjs --query "zai 5.1" ``` Manage OpenWork models: ```bash node .opencode/skills/openwork-models/scripts/openwork-models.mjs search "zai 5.1" node .opencode/skills/openwork-models/scripts/openwork-models.mjs add "z-ai/glm-5.1" node .opencode/skills/openwork-models/scripts/openwork-models.mjs remove "z-ai/glm-5.1" node .opencode/skills/openwork-models/scripts/openwork-models.mjs discount 0.1 "z-ai/glm-5.1" node .opencode/skills/openwork-models/scripts/openwork-models.mjs sync node .opencode/skills/openwork-models/scripts/openwork-models.mjs validate ``` Trigger the remote base model refresh workflow: ```bash node .opencode/skills/openwork-models/scripts/trigger-update-workflow.mjs node .opencode/skills/openwork-models/scripts/trigger-update-workflow.mjs --base dev --ref dev ``` ## Update Models Workflow When the user asks to update/refresh/sync the models from models.dev, do not edit `base.json` manually. Trigger `.github/workflows/update-models.yml` and wait for the result: ```bash node .opencode/skills/openwork-models/scripts/trigger-update-workflow.mjs ``` The script dispatches the manual workflow, watches the run, finds the automation PR, waits until auto-merge completes, and prints the merged PR URL. If the workflow finds no model changes, report that no PR was created and include the workflow run URL. If the workflow or PR fails/closes unmerged, report that failure with the run/PR URL. ## Add Workflow 1. Run `extract-source-models.mjs --query "<user text>"` or `openwork-models.mjs search "<user text>"`. 2. If there is no good match, ask the user for clarification. 3. If there are multiple plausible matches, list the matching IDs and ask which one(s) to add. 4. Once exact IDs are known, run `openwork-models.mjs add "<id>"` for each ID. The script copies the full model block from `openrouter.models`, adds it to `openwork-models.json`, syncs aliases, and validates. New aliases use: ```ts "model/id": { upstreamModel: "model/id", displayName: "OpenWork: " + model.name, enabled: true, usageFactor: 1, } ``` Preserve existing `usageFactor` values when syncing. New models default to `1`. ## Remove Workflow 1. Resolve exact IDs with `search` if needed. 2. Run `openwork-models.mjs remove "<id>"`. 3. The script removes the model from `openwork-models.json`, removes the alias by regenerating the alias map from the model list, and validates. ## Discount Workflow A usage factor is the charged fraction of normal price: - `1` means 100% price. - `0.1` means 10% price, a 90% discount. Always clarify exact model IDs before changing discounts, especially if the user provides a partial string or asks for multiple models. Then run: ```bash node .opencode/skills/openwork-models/scripts/openwork-models.mjs discount <factor> "<id>" ["<id2>"] ``` ## Validation Before finishing, run: ```bash node .opencode/skills/openwork-models/scripts/openwork-models.mjs validate node ee/apps/gateway/scripts/build-models.mjs ``` Validation checks JSON validity, OpenWork model ID consistency, and alias coverage in `INFERENCE_MODEL_ALIASES`.