@exellix/ai-tasks 8.4.2 → 8.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/.docs/DOWNSTREAM_ENV.md +42 -0
  2. package/.docs/FEEDBACK_TO_CLIENT_DOWNSTREAM_FIXES.md +64 -0
  3. package/.docs/INTERMEDIATE_STEPS.md +82 -0
  4. package/.docs/activity-structure.md +31 -0
  5. package/.docs/ai-task-ai-scoping-spec.md +338 -0
  6. package/.docs/ai-tasks-model-profile-aliases-7x.md +74 -0
  7. package/.docs/blockers-and-issues.md +346 -0
  8. package/.docs/building-runTask-sdk.md +659 -0
  9. package/.docs/building-skill-execution-orchestrator.md +968 -0
  10. package/.docs/code-used-before/run-task.txt +39 -0
  11. package/.docs/code-used-before/task-executor.ts.old +57 -0
  12. package/.docs/code-used-before/test-run-task.ts.old +42 -0
  13. package/.docs/code-used-before/types.txt +23 -0
  14. package/.docs/env-ready-policy.md +40 -0
  15. package/.docs/flow-io/flow-README.md +76 -0
  16. package/.docs/flow-io/narrix.md +124 -0
  17. package/.docs/flow-io/web-scoping.md +135 -0
  18. package/.docs/flow-io/xynthesis-post.md +154 -0
  19. package/.docs/flow-io/xynthesis-pre.md +181 -0
  20. package/.docs/gap-analysis.md +201 -0
  21. package/.docs/integration-facts-ai-tasks.md +109 -0
  22. package/.docs/investigation/ai-skills.md +170 -0
  23. package/.docs/investigation/external-packages-assignments.md +66 -0
  24. package/.docs/investigation/integration-summary.md +20 -0
  25. package/.docs/investigation/narrix-catalox.md +29 -0
  26. package/.docs/investigation/workplan-close-graph-engine-gaps.md +101 -0
  27. package/.docs/logging-stack.md +30 -0
  28. package/.docs/memory-narrix-adapter-developer-guide.md +402 -0
  29. package/.docs/memory-narrix-adapter-requirements.md +112 -0
  30. package/.docs/narrix-context-consumption-gap.md +184 -0
  31. package/.docs/narrix-context-downstream-report.md +30 -0
  32. package/.docs/narrix-ingest-and-packs-library-spec.md +240 -0
  33. package/.docs/narrix-record-input-current-design.md +48 -0
  34. package/.docs/pacakge.md +48 -0
  35. package/.docs/possible-components/README.md +11 -0
  36. package/.docs/possible-components/integration/README.md +10 -0
  37. package/.docs/possible-components/integration/gaps-when-merging.md +16 -0
  38. package/.docs/possible-components/integration/platform.md +54 -0
  39. package/.docs/possible-components/integration/reintegrate-into-ai-tasks.md +26 -0
  40. package/.docs/possible-components/integration/roadmap-and-checklists.md +54 -0
  41. package/.docs/possible-components/post-component/README.md +18 -0
  42. package/.docs/possible-components/post-component/builder-guide.md +175 -0
  43. package/.docs/possible-components/post-component/gaps-and-artifacts.md +52 -0
  44. package/.docs/possible-components/post-component/handler-audit.md +47 -0
  45. package/.docs/possible-components/post-component/handler-polish.md +41 -0
  46. package/.docs/possible-components/post-component/unified-protocol.md +59 -0
  47. package/.docs/possible-components/pre-component/README.md +22 -0
  48. package/.docs/possible-components/pre-component/builder-guide.md +127 -0
  49. package/.docs/possible-components/pre-component/gaps-and-artifacts.md +35 -0
  50. package/.docs/possible-components/pre-component/handler-ai-scoping.md +45 -0
  51. package/.docs/possible-components/pre-component/handler-narrix-preprocessor.md +49 -0
  52. package/.docs/possible-components/pre-component/handler-narrix-system2.md +35 -0
  53. package/.docs/possible-components/pre-component/handler-synthesized-context.md +65 -0
  54. package/.docs/possible-components/pre-component/handler-web-scope.md +29 -0
  55. package/.docs/possible-components/pre-component/unified-protocol.md +89 -0
  56. package/.docs/prefer-openrouter-routing-policy.md +132 -0
  57. package/.docs/questions-for-ai-skills.md +123 -0
  58. package/.docs/realtime-narrixing-gap-analysis.md +40 -0
  59. package/.docs/realtime-narrixing.md +433 -0
  60. package/.docs/run-context-object.md +32 -0
  61. package/.docs/session-id-usage.md +26 -0
  62. package/.docs/skill-library-spec.md +249 -0
  63. package/.docs/synthesized-context-strategy-spec.md +906 -0
  64. package/.docs/upstream-issue/2026-03-21_woroces-ai-tasks_ISSUE-006_web-scope-question-from-cni-entity.md +46 -0
  65. package/.docs/web-scopper-embed.md +93 -0
  66. package/.docs/xynthesis-wiring-and-io.md +12 -0
  67. package/README.md +15 -13
  68. package/dist/index.d.ts +2 -1
  69. package/dist/index.d.ts.map +1 -1
  70. package/dist/index.js +1 -1
  71. package/dist/index.js.map +1 -1
  72. package/dist/internal/runPostStepLlmCall.d.ts.map +1 -1
  73. package/dist/internal/runPostStepLlmCall.js +4 -2
  74. package/dist/internal/runPostStepLlmCall.js.map +1 -1
  75. package/dist/invocation/resolveProfileInvocationRouting.js +2 -2
  76. package/dist/invocation/resolveProfileInvocationRouting.js.map +1 -1
  77. package/dist/utils/aiProfileModelFormat.d.ts +2 -2
  78. package/dist/utils/aiProfileModelFormat.js +2 -2
  79. package/dist/utils/aiProfilesCatalog.d.ts +16 -0
  80. package/dist/utils/aiProfilesCatalog.d.ts.map +1 -0
  81. package/dist/utils/aiProfilesCatalog.js +23 -0
  82. package/dist/utils/aiProfilesCatalog.js.map +1 -0
  83. package/dist/utils/resolveAiProfileModel.d.ts +2 -2
  84. package/dist/utils/resolveAiProfileModel.d.ts.map +1 -1
  85. package/dist/utils/resolveAiProfileModel.js +5 -5
  86. package/dist/utils/resolveAiProfileModel.js.map +1 -1
  87. package/dist/utils/routeModelConfigSlots.d.ts +3 -1
  88. package/dist/utils/routeModelConfigSlots.d.ts.map +1 -1
  89. package/dist/utils/routeModelConfigSlots.js +2 -1
  90. package/dist/utils/routeModelConfigSlots.js.map +1 -1
  91. package/documenations/upstream-feature-requests/README.md +2 -2
  92. package/documenations/upstream-feature-requests/ai-tasks-wrap-up-after-upstream.md +5 -2
  93. package/documenations/upstream-feature-requests/xynthesis-orchestrator-invoke-contract-4.2.md +2 -2
  94. package/package.json +2 -1
@@ -1,4 +1,5 @@
1
1
  export { buildAiSkillsModelConfigForMain, getPreActionModelFromSlots, getPostActionModelFromSlots, getSkillModelFromSlots, isRootLlmCallPreMainModelCollision, resolveMainSkillModel, resolvePostActionModel, resolvePreActionModel, } from "../types/model-config.js";
2
- export { formatResolvedProfileModelId, isAliasLikeModelValue, isResolvableModelAlias, normalizeXynthesisModelAlias, resolveModelReference, resolveModelReferenceForXynthesis, } from "./resolveAiProfileModel.js";
2
+ export { formatResolvedProfileModelId, isAliasLikeModelValue, isResolvableModelAlias, normalizeXynthesisModelAlias, toStrictAiProfileResolveInput, resolveModelReference, resolveModelReferenceForXynthesis, } from "./resolveAiProfileModel.js";
3
+ export { listAiTasksProfileChoices, listAiTasksProfiles, listAiTasksProfileChoiceKeys, } from "./aiProfilesCatalog.js";
3
4
  export { resolveRunTaskModelReferences } from "./resolveRunTaskModelReferences.js";
4
5
  //# sourceMappingURL=routeModelConfigSlots.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"routeModelConfigSlots.js","sourceRoot":"","sources":["../../src/utils/routeModelConfigSlots.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,kCAAkC,EAClC,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC"}
1
+ {"version":3,"file":"routeModelConfigSlots.js","sourceRoot":"","sources":["../../src/utils/routeModelConfigSlots.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,2BAA2B,EAC3B,sBAAsB,EACtB,kCAAkC,EAClC,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,qBAAqB,EACrB,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC"}
@@ -7,8 +7,8 @@ Fix reports filed for sibling packages. Hand these to the package owners; after
7
7
  | Package | Document | Status |
8
8
  |---------|----------|--------|
9
9
  | `@exellix/ai-skills` 6.0 | [ai-skills-orchestrator-invoke-contract-5.9.md](./ai-skills-orchestrator-invoke-contract-5.9.md) | **shipped** — `ModelConfig.reasoningEffort` |
10
- | `@exellix/xynthesis` 4.3 | [**xynthesis-ai-profiles-2.1-import-break.md**](./xynthesis-ai-profiles-2.1-import-break.md) | **P0 blocked** **4.3.0** breaks `import "@exellix/xynthesis"` with ai-profiles **2.1.0**; need **≥ 4.3.1** |
11
- | `@exellix/xynthesis` 4.3 | [xynthesis-orchestrator-invoke-contract-4.2.md](./xynthesis-orchestrator-invoke-contract-4.2.md) | **partial** — `reasoningEffort` shipped in 4.3.0; import break tracked in CR above |
10
+ | `@exellix/xynthesis` 4.3 | [**xynthesis-ai-profiles-2.1-import-break.md**](./xynthesis-ai-profiles-2.1-import-break.md) | **shipped** in **4.3.1** ai-profiles 2.1 import + profile/choice resolve |
11
+ | `@exellix/xynthesis` 4.3 | [xynthesis-orchestrator-invoke-contract-4.2.md](./xynthesis-orchestrator-invoke-contract-4.2.md) | **partial** — `reasoningEffort` shipped in 4.3.0; ai-profiles 2.1 import fixed in **4.3.1** (see CR above) |
12
12
  | `@x12i/ai-profiles` 2.1 | — | **shipped** — `catalogLane` required; sync `isKnownProfileOrShortcut` removed (safer — resolve at invoke) |
13
13
  | `@exellix/ai-tasks` | [ai-tasks-wrap-up-after-upstream.md](./ai-tasks-wrap-up-after-upstream.md) | **done** in 8.4 — no legacy tiers; resolve at invoke via `resolveAIProfile` |
14
14
 
@@ -1,6 +1,6 @@
1
1
  # `@exellix/ai-tasks` — wrap-up after upstream invoke-contract fixes
2
2
 
3
- Status: **blocked** on **@exellix/xynthesis ≥ 4.3.1** ([xynthesis-ai-profiles-2.1-import-break.md](./xynthesis-ai-profiles-2.1-import-break.md)); invoke-contract items below are otherwise shipped in **ai-skills 6.0** / **xynthesis 4.3**:
3
+ Status: **unblocked** **@exellix/xynthesis ≥ 4.3.1** shipped ([xynthesis-ai-profiles-2.1-import-break.md](./xynthesis-ai-profiles-2.1-import-break.md)); invoke-contract items below are shipped in **ai-skills 6.0** / **xynthesis 4.3**:
4
4
 
5
5
  - [`ai-skills-orchestrator-invoke-contract-5.9.md`](./ai-skills-orchestrator-invoke-contract-5.9.md)
6
6
  - [`xynthesis-orchestrator-invoke-contract-4.2.md`](./xynthesis-orchestrator-invoke-contract-4.2.md)
@@ -35,7 +35,10 @@ Target release: **8.4.x** (or **8.5.0** if breaking `llmCall` surface)
35
35
  - [x] Removed `maxTokens` from `RunTaskModelConfig`; strip legacy key at ai-skills boundary.
36
36
  - [x] Stopped mapping `llmCall.maxTokensCap` → `modelConfig.maxTokens` in `buildAiSkillsModelConfigForMain`.
37
37
  - [x] Trace repair: `mapGatewayInvokeToTrace` uses `maxTokensRequested` only (not `modelConfig.maxTokens`).
38
- - [x] README / BREAKING-CHANGES partial updates for modelConfig + MAIN Optimixer.
38
+ - [x] `@exellix/xynthesis` 4.3.1 in `package.json`; bare profile keys normalized via `toStrictAiProfileResolveInput` before xynthesis invoke.
39
+ - [x] Tests/fixtures use `cheap/default` + `pro/default` (no legacy `balanced` default).
40
+ - [x] Public exports: `listAiTasksProfileChoiceKeys`, `toStrictAiProfileResolveInput`.
41
+ - [x] `npm run build` + `npm run test` green (390 pass / 0 fail).
39
42
 
40
43
  ---
41
44
 
@@ -167,8 +167,8 @@ ai-tasks will follow whichever contract is published; default integration is **n
167
167
 
168
168
  ## Verification checklist (for xynthesis PR)
169
169
 
170
- - [ ] Replace `isKnownProfileOrShortcut` → `isKnownProfileChoice` (index re-export + `resolveAiProfileModel` / `assertKnownModelAlias`).
171
- - [ ] `import "@exellix/xynthesis"` succeeds with `@x12i/ai-profiles@2.1.0` installed.
170
+ - [x] Replace `isKnownProfileOrShortcut` → `isKnownProfileChoice` (shipped in **4.3.1** see [xynthesis-ai-profiles-2.1-import-break.md](./xynthesis-ai-profiles-2.1-import-break.md)).
171
+ - [x] `import "@exellix/xynthesis"` succeeds with `@x12i/ai-profiles@2.1.0` installed.
172
172
  - [ ] `ExecuteXynthesisActionRequest.reasoningEffort` (and gateway wrappers).
173
173
  - [ ] Optimixer predict receives resolved `reasoningEffort`.
174
174
  - [ ] `temperature` + `topP` integration tests on `executeXynthesisAction` + structured gateway.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@exellix/ai-tasks",
3
- "version": "8.4.2",
3
+ "version": "8.4.3",
4
4
  "description": "Task orchestration for the Exellix stack: runTask() with local handlers or LLM-backed execution, task-scoped memory/context enrichment, and executor dispatch via @exellix/ai-skills. ERC-compliant.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -14,6 +14,7 @@
14
14
  "CHANGELOG.md",
15
15
  "RUNTASK_REQUEST.md",
16
16
  "documenations",
17
+ ".docs",
17
18
  ".env.example",
18
19
  ".metadata"
19
20
  ],