@nomix-ai/nomix-harness 0.2.0 → 0.2.1

package/README.md

@@ -2,7 +2,7 @@
 
 English | [中文](README.zh.md)
 
-The `nomix` command is the product launcher for profiles: ordered stacks of plugin-bundle patch layers under the user's own overrides. The npm release is one portable `@nomix-ai/nomix-harness` tarball whose install lifecycle restores the in-repository runtime packages with the host `tar` command and falls back to its JavaScript extractor when that command is unavailable; npm installs `sharp`, `koffi`, and the built-in loader for the consumer's Windows, macOS, or Linux platform. Installation must allow package lifecycle scripts and optional dependencies; `--ignore-scripts` or `--omit=optional` leaves the runtime unavailable. [`src/args.ts`](src/args.ts) owns the command grammar, and [`src/bin.ts`](src/bin.ts) loads only the selected runner. Invalid commands, options from another mode, configuration errors, and boot failures exit nonzero.
+The `nomix` command is the product launcher for profiles: ordered stacks of plugin-bundle patch layers under the user's own overrides. The npm release is one script-free `@nomix-ai/nomix-harness` tarball containing the compiled runtime, built-in plugins, bundles, Web assets, SDK, and platform-independent resources. `npm install --ignore-scripts` is supported; omitting optional dependencies disables only the platform capabilities they provide. [`src/args.ts`](src/args.ts) owns the command grammar, and [`src/bin.ts`](src/bin.ts) loads only the selected runner. Invalid commands, options from another mode, configuration errors, and boot failures exit nonzero.
 
 ## Entry modes
 
@@ -16,8 +16,8 @@ The `nomix` command is the product launcher for profiles: ordered stacks of plug
 Without a persistent installation, npm can install and execute the same CLI from its cache:
 
 ```sh
-npx --yes --package @nomix-ai/nomix-harness@0.1.2 nomix --version
-npx --yes --package @nomix-ai/nomix-harness@0.1.2 nomix --profile headless "task"
+npx --yes --package @nomix-ai/nomix-harness nomix --version
+npx --yes --package @nomix-ai/nomix-harness nomix --profile headless "task"
 ```
 
 The invoking directory is the default workspace root. The `web` and `headless` profiles auto-initialize on first use from shipped templates; any other profile must be created through `nomix plugin`.
@@ -43,7 +43,7 @@ The tree composes over an empty root:
 - then the profile's `cordis.patch.yml`, then the home-level `$NOMIX_HOME/cordis.patch.yml`
 - then `--patch` overlays
 
-Bundles named in `nomix.profile.bundles` resolve from the nomix installation first (`@nomix-ai/nomix-base`, `@nomix-ai/nomix-web-app`, `@nomix-ai/nomix-headless`), then from the profile's own `node_modules`, where pnpm installs out-of-tree plugins.
+Bundles named in `nomix.profile.bundles` resolve from the nomix installation first (`@nomix-ai/nomix-base`, `@nomix-ai/nomix-web-app`, `@nomix-ai/nomix-headless`), then from the profile's own `node_modules`, where pnpm installs out-of-tree plugins. The launcher maintains package-name links from `$NOMIX_HOME/profiles/node_modules` into the aggregate package's internal kernel so Loader imports and package metadata discovery use the same canonical names.
 
 Use `--dump-default-config` and `--dump-config` to inspect the composed tree without booting it.
 

package/dist/bundles/base/cordis.patch.yml

@@ -22,29 +22,29 @@
         root: ['.']
 
     - id: llm
-      name: 'cordis:nomix/llm'
+      name: '@nomix-ai/nomix-llm'
 
     - id: session
-      name: 'cordis:nomix/session'
+      name: '@nomix-ai/nomix-session'
 
     - id: typert
-      name: 'cordis:nomix/typert-registry'
+      name: '@nomix-ai/nomix-typert-registry'
 
     - id: typert-loader
-      name: 'cordis:nomix/typert-loader'
+      name: '@nomix-ai/nomix-typert-loader'
 
     - id: typert-gateway
-      name: 'cordis:nomix/api-gateway'
+      name: '@nomix-ai/nomix-api-gateway'
 
     - id: session-title
-      name: 'cordis:nomix/session-title'
+      name: '@nomix-ai/nomix-session-title'
       config:
         fallbackMaxWords: 5
         fallbackMaxBytes: 40
         maxTitleBytes: 80
 
     - id: session-title-llm
-      name: 'cordis:nomix/session-title-first-prompt-llm'
+      name: '@nomix-ai/nomix-session-title-first-prompt-llm'
       config:
         targetWords: 5
         targetCjkCharacters: 10
@@ -53,36 +53,36 @@
         timeoutMs: 60000
 
     - id: user-questions
-      name: 'cordis:nomix/user-questions'
+      name: '@nomix-ai/nomix-user-questions'
 
     - id: agent
-      name: 'cordis:nomix/agent'
+      name: '@nomix-ai/nomix-agent'
 
     # The transport-independent default for Agents created by entry points.
     # Settings may supply a saved selection; consumers read it at creation time.
     - id: agent-default-model
-      name: 'cordis:nomix/agent-default-model'
+      name: '@nomix-ai/nomix-agent-default-model'
       config:
         provider: unconfigured
         model: unconfigured
 
     - id: jobs
-      name: 'cordis:nomix/jobs-local'
+      name: '@nomix-ai/nomix-jobs-local'
 
     - id: llm-retry
-      name: 'cordis:nomix/llm-retry'
+      name: '@nomix-ai/nomix-llm-retry'
 
     # User-settings document (`$NOMIX_HOME/settings.yaml`, hot-reloaded):
     # provider sections override explicitly registered adapters without a restart.
     - id: settings
-      name: 'cordis:nomix/settings-file'
+      name: '@nomix-ai/nomix-settings-file'
 
     # Credential sources: inherited environment over the managed
     # `$NOMIX_HOME/.credentials.yaml`, with project and user `.env` fallbacks.
     # Adapters resolve references per request; the Models page writes only the
     # managed document, which is never materialized into the process environment.
     - id: credentials
-      name: 'cordis:nomix/credentials-local'
+      name: '@nomix-ai/nomix-credentials-local'
 
     # The pi-ai multi-provider twin, mounted dormant: zero routes (and no extra
     # models in the picker) until a `llm-pi-ai:` settings section supplies provider
@@ -92,10 +92,10 @@
     # adapters exist is composition; which providers run is the user's settings
     # document.
     - id: llm-pi-ai
-      name: 'cordis:nomix/llm-pi-ai'
+      name: '@nomix-ai/nomix-llm-pi-ai'
 
     - id: session-persistence-jsonl
-      name: 'cordis:nomix/session-persistence-jsonl'
+      name: '@nomix-ai/nomix-session-persistence-jsonl'
       config:
         root: !!js nomixHomePath('sessions')
 
@@ -103,7 +103,7 @@
     # keep content-addressed references that this shared backend resolves for
     # provider requests and authorized history reads.
     - id: attachment-local
-      name: 'cordis:nomix/attachment-local'
+      name: '@nomix-ai/nomix-attachment-local'
 
     # Full-text session search is opt-in. `openAt: never` keeps
     # ctx.sessionQuery mounted — exact reads, titles, and lineage traces
@@ -114,7 +114,7 @@
     # `first-search` or `startup` in a later patch layer (profile
     # cordis.patch.yml or a --patch overlay), typically with a durable `path`.
     - id: session-query-sqlite
-      name: 'cordis:nomix/session-query-sqlite'
+      name: '@nomix-ai/nomix-session-query-sqlite'
       config:
         path: ':memory:'
         openAt: never
@@ -123,7 +123,7 @@
     # through its registered units, so the `list_agents` surface below fails
     # loud without it; web layers reuse this same mount for list rows.
     - id: session-projection
-      name: 'cordis:nomix/session-projection'
+      name: '@nomix-ai/nomix-session-projection'
 
     # Session telemetry is mounted but disabled by default. NOMIX_TELEMETRY_MODE
     # explicitly opts into FULL or FEEDBACK_ONLY reporting; uploading mirrors
@@ -145,7 +145,7 @@
     # promise never settles. Every CLI exit path drains it by disposing the root
     # on SIGINT/SIGTERM.
     - id: session-telemetry-otel
-      name: 'cordis:nomix/session-telemetry-otel'
+      name: '@nomix-ai/nomix-session-telemetry-otel'
       config:
         mode: !!js process.env.NOMIX_TELEMETRY_MODE || 'DISABLED'
         shutdownTimeoutMillis: 3000
@@ -156,37 +156,37 @@
           exportTimeoutMillis: 1500
 
     - id: subprocess
-      name: 'cordis:nomix/subprocess-local'
+      name: '@nomix-ai/nomix-subprocess-local'
 
     # Every shipped CLI mode starts with the same file-effect boundary.
     # The environment remains an explicit deployment override; otherwise fresh
     # sessions pin workspace-write + ask through the permission service below.
     - id: sandbox
-      name: 'cordis:nomix/sandbox-local'
+      name: '@nomix-ai/nomix-sandbox-local'
 
     - id: sandbox-policy
-      name: 'cordis:nomix/sandbox-policy'
+      name: '@nomix-ai/nomix-sandbox-policy'
       config:
         mode: !!js process.env.NOMIX_PERMISSION_MODE ?? 'workspace-write'
         workspaceRoot: !!js process.cwd()
 
     - id: bash-sandbox
-      name: 'cordis:nomix/bash-sandbox'
+      name: '@nomix-ai/nomix-bash-sandbox'
       disabled: !!js process.platform === 'win32'
       config:
         timeoutMs: 60000
 
     - id: pwsh-sandbox
-      name: 'cordis:nomix/pwsh-sandbox'
+      name: '@nomix-ai/nomix-pwsh-sandbox'
       disabled: !!js process.platform !== 'win32'
 
     - id: approval
-      name: 'cordis:nomix/user-approval'
+      name: '@nomix-ai/nomix-user-approval'
       config:
         policy: !!js "(process.env.NOMIX_PERMISSION_MODE ?? 'workspace-write') === 'danger-full-access' ? 'never' : 'ask'"
 
     - id: permission
-      name: 'cordis:nomix/permission-presets'
+      name: '@nomix-ai/nomix-permission-presets'
       config:
         presets:
           read-only:
@@ -200,65 +200,65 @@
             approval: never
 
     - id: shell-env
-      name: 'cordis:nomix/shell-env'
+      name: '@nomix-ai/nomix-shell-env'
 
     - id: tool-bash
-      name: 'cordis:nomix/tool-bash'
+      name: '@nomix-ai/nomix-tool-bash'
       disabled: !!js process.platform === 'win32'
 
     - id: tool-pwsh
-      name: 'cordis:nomix/tool-pwsh'
+      name: '@nomix-ai/nomix-tool-pwsh'
       disabled: !!js process.platform !== 'win32'
 
     - id: tool-jobs
-      name: 'cordis:nomix/tool-jobs'
+      name: '@nomix-ai/nomix-tool-jobs'
 
     - id: fs-observation-policy
-      name: 'cordis:nomix/fs-observation-policy'
+      name: '@nomix-ai/nomix-fs-observation-policy'
 
     - id: tool-fs
-      name: 'cordis:nomix/tool-fs'
+      name: '@nomix-ai/nomix-tool-fs'
 
     - id: tool-fs-search
-      name: 'cordis:nomix/tool-fs-search'
+      name: '@nomix-ai/nomix-tool-fs-search'
       config:
         sampleOverCapGlobResults: false
 
     - id: agent-instructions
-      name: 'cordis:nomix/agent-instructions'
+      name: '@nomix-ai/nomix-agent-instructions'
       config:
         maxBytes: 65536
 
     - id: skill
-      name: 'cordis:nomix/skill'
+      name: '@nomix-ai/nomix-skill'
 
     - id: skill-filesystem
-      name: 'cordis:nomix/skill-filesystem'
+      name: '@nomix-ai/nomix-skill-filesystem'
 
     - id: skill-badge
-      name: 'cordis:nomix/skill-badge'
+      name: '@nomix-ai/nomix-skill-badge'
       disabled: true
 
     - id: tool-skill
-      name: 'cordis:nomix/tool-skill'
+      name: '@nomix-ai/nomix-tool-skill'
 
     - id: commands
-      name: 'cordis:nomix/commands'
+      name: '@nomix-ai/nomix-commands'
 
     - id: command-feedback
-      name: 'cordis:nomix/command-feedback'
+      name: '@nomix-ai/nomix-command-feedback'
 
     - id: goal
-      name: 'cordis:nomix/goal'
+      name: '@nomix-ai/nomix-goal'
 
     - id: goal-round-driver
-      name: 'cordis:nomix/goal-round-driver'
+      name: '@nomix-ai/nomix-goal-round-driver'
 
     - id: command-goal
-      name: 'cordis:nomix/command-goal'
+      name: '@nomix-ai/nomix-command-goal'
 
     - id: plan-mode
-      name: 'cordis:nomix/plan-mode'
+      name: '@nomix-ai/nomix-plan-mode'
       config:
         section: |
               You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
@@ -274,39 +274,39 @@
               When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
 
     - id: token-meter
-      name: 'cordis:nomix/token-meter'
+      name: '@nomix-ai/nomix-token-meter'
 
     - id: compaction-basic
-      name: 'cordis:nomix/compaction-basic'
+      name: '@nomix-ai/nomix-compaction-basic'
 
     # Human `/compact`: one useful reduction below the automatic threshold. Backend
     # independent, so it follows whichever compaction service this leaf mounts.
     - id: command-compact
-      name: 'cordis:nomix/command-compact'
+      name: '@nomix-ai/nomix-command-compact'
 
     - id: subagent
-      name: 'cordis:nomix/subagent'
+      name: '@nomix-ai/nomix-subagent'
 
     - id: subagent-spawn-in-process
-      name: 'cordis:nomix/subagent-spawn-in-process'
+      name: '@nomix-ai/nomix-subagent-spawn-in-process'
       config:
         providerName: spawn
 
     - id: subagent-fork-in-process
-      name: 'cordis:nomix/subagent-fork-in-process'
+      name: '@nomix-ai/nomix-subagent-fork-in-process'
       config:
         providerName: fork
 
     # Continuable background children are selected per delegation tool. The
     # separately loaded follow-up tool registers the one global `send_message`.
     - id: tool-subagent-control
-      name: 'cordis:nomix/tool-subagent-control'
+      name: '@nomix-ai/nomix-tool-subagent-control'
 
     - id: tool-subagent-list-agents
-      name: 'cordis:nomix/tool-subagent-control/list-agents'
+      name: '@nomix-ai/nomix-tool-subagent-control/list-agents'
 
     - id: tool-subagent
-      name: 'cordis:nomix/tool-subagent'
+      name: '@nomix-ai/nomix-tool-subagent'
       config:
         provider: spawn
         toolName: subagent
@@ -317,7 +317,7 @@
     # fork children install neither, keeping the parent's request prefix.
     # See .agents/notes/implemented/architecture/2026-08-10-fork-children-stay-one-shot.md.
     - id: tool-subagent-fork
-      name: 'cordis:nomix/tool-subagent'
+      name: '@nomix-ai/nomix-tool-subagent'
       config:
         provider: fork
         toolName: subagent_fork
@@ -325,65 +325,65 @@
 
     # Optional direct-child return channel; absent from roots and one-shot agents.
     - id: tool-subagent-report
-      name: 'cordis:nomix/tool-subagent-report'
+      name: '@nomix-ai/nomix-tool-subagent-report'
 
     - id: workflow-worker-thread
-      name: 'cordis:nomix/workflow-worker-thread'
+      name: '@nomix-ai/nomix-workflow-worker-thread'
       config:
         provider: spawn
 
     - id: tool-workflow
-      name: 'cordis:nomix/tool-workflow'
+      name: '@nomix-ai/nomix-tool-workflow'
 
     - id: timeout-policy
-      name: 'cordis:nomix/tool-call-timeout-policy'
+      name: '@nomix-ai/nomix-tool-call-timeout-policy'
 
     - id: spill-local
-      name: 'cordis:nomix/spill-local'
+      name: '@nomix-ai/nomix-spill-local'
 
     - id: spill-policy
-      name: 'cordis:nomix/spill-policy'
+      name: '@nomix-ai/nomix-spill-policy'
       config:
         maxInlineBytes: 50000
 
     # Durability checkpoints before each model request and top-level dispatch.
     - id: session-checkpoint-policy
-      name: 'cordis:nomix/session-checkpoint-policy'
+      name: '@nomix-ai/nomix-session-checkpoint-policy'
 
     # Compacts oversized tool results before the broader conversation compactor
     # runs, preserving the model-visible result within the configured budget.
     - id: tool-result-pruner
-      name: 'cordis:nomix/compaction-tool-result-pruner'
+      name: '@nomix-ai/nomix-compaction-tool-result-pruner'
       config:
         thresholdChars: 8192
         headChars: 4096
         tailChars: 1024
 
     - id: tool-todo
-      name: 'cordis:nomix/tool-todo'
+      name: '@nomix-ai/nomix-tool-todo'
       config:
         allowParallelInProgress: true
 
     # Persisted same-session goals reach the model and the slash menu here; the
     # domain, driver, and `/goal` command are above.
     - id: tool-goal
-      name: 'cordis:nomix/tool-goal'
+      name: '@nomix-ai/nomix-tool-goal'
 
     # Fresh-agent Ralph iteration over a build-time-fixed script.
     - id: tool-ralph
-      name: 'cordis:nomix/tool-ralph'
+      name: '@nomix-ai/nomix-tool-ralph'
       config:
         subagentProvider: spawn
         maxRounds: 64
 
     - id: tool-str-replace-editor
-      name: 'cordis:nomix/tool-str-replace-editor'
+      name: '@nomix-ai/nomix-tool-str-replace-editor'
       config:
         maxOutputChars: 16000
 
     # Consecutive-repeat reminders on the tool chain.
     - id: repeat-tool-reminder
-      name: 'cordis:nomix/repeat-tool-reminder'
+      name: '@nomix-ai/nomix-repeat-tool-reminder'
       config:
         thresholds: [3, 5, 8]
         argumentsPreviewChars: 500
@@ -391,10 +391,10 @@
     # The base exposes the provider-neutral web tool without selecting a search
     # provider. Deployments register and select a provider explicitly.
     - id: web
-      name: 'cordis:nomix/web'
+      name: '@nomix-ai/nomix-web'
 
     - id: tool-web
-      name: 'cordis:nomix/tool-web'
+      name: '@nomix-ai/nomix-tool-web'
       config:
         fetch: false
         searchTimeoutMs: 60000
@@ -404,23 +404,23 @@
     # The tool registry. Presentation mode is a deployment choice; omitting it here
     # keeps the schema default (native).
     - id: tools
-      name: 'cordis:nomix/tools'
+      name: '@nomix-ai/nomix-tools'
 
     # The deployment persona is a deployment choice; plan-mode and tool plugins own
     # their own prompt sections.
     - id: system-prompt
-      name: 'cordis:nomix/system-prompt'
+      name: '@nomix-ai/nomix-system-prompt'
       config:
         persona: ''
 
     # Agents created at startup. The base stays empty; raw overlays may create
     # agents, while Web creates sessions on client request.
     - id: agent-loop
-      name: 'cordis:nomix/agent-loop'
+      name: '@nomix-ai/nomix-agent-loop'
       config:
         agents: []
 
     # The sandboxed filesystem provider. `cwd` defaults to `process.cwd()`; an
     # overlay can pin another workspace.
     - id: fs-sandbox
-      name: 'cordis:nomix/fs-sandbox'
+      name: '@nomix-ai/nomix-fs-sandbox'

package/dist/bundles/headless/cordis.patch.yml

@@ -22,14 +22,14 @@
 - insert:
     # Code Mode is a core execution capability, not a Web component.
     - id: code-runtime
-      name: 'cordis:nomix/code-runtime-worker-thread'
+      name: '@nomix-ai/nomix-code-runtime-worker-thread'
 
     - id: headless-startup
-      name: 'cordis:nomix/headless/startup'
+      name: '@nomix-ai/nomix-headless/startup'
 
     # Reads its task from the ordinary headlessStartup provider.
     - id: headless-runner
-      name: 'cordis:nomix/headless'
+      name: '@nomix-ai/nomix-headless'
       inject: [headlessStartup]
       config:
         task: !!js ctx.headlessStartup.task