@plurnk/plurnk-providers 6.0.3 → 6.1.1

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 (76) hide show
  1. package/.env.defaults +4 -5
  2. package/README.md +31 -213
  3. package/SPEC.md +11 -7
  4. package/dist/InferenceAdmission.js.map +1 -1
  5. package/dist/LeadingReasoning.d.ts.map +1 -1
  6. package/dist/LeadingReasoning.js +12 -1
  7. package/dist/LeadingReasoning.js.map +1 -1
  8. package/dist/Mock.d.ts +5 -1
  9. package/dist/Mock.d.ts.map +1 -1
  10. package/dist/Mock.js +7 -1
  11. package/dist/Mock.js.map +1 -1
  12. package/dist/ModelProvider.d.ts +6 -3
  13. package/dist/ModelProvider.d.ts.map +1 -1
  14. package/dist/ModelProvider.js +24 -24
  15. package/dist/ModelProvider.js.map +1 -1
  16. package/dist/ModelRequestBody.js.map +1 -1
  17. package/dist/Pool.d.ts +2 -0
  18. package/dist/Pool.d.ts.map +1 -1
  19. package/dist/Pool.js +8 -0
  20. package/dist/Pool.js.map +1 -1
  21. package/dist/ProviderRegistry.d.ts.map +1 -1
  22. package/dist/ProviderRegistry.js +5 -10
  23. package/dist/ProviderRegistry.js.map +1 -1
  24. package/dist/RequestCapture.js.map +1 -1
  25. package/dist/accounting.js.map +1 -1
  26. package/dist/accountingPublic.js.map +1 -1
  27. package/dist/capacity.js.map +1 -1
  28. package/dist/catalogProvider.d.ts +2 -2
  29. package/dist/catalogProvider.d.ts.map +1 -1
  30. package/dist/catalogProvider.js +4 -4
  31. package/dist/catalogProvider.js.map +1 -1
  32. package/dist/compatibleProvider.js.map +1 -1
  33. package/dist/cost.js.map +1 -1
  34. package/dist/defaults.js.map +1 -1
  35. package/dist/discover.d.ts +0 -2
  36. package/dist/discover.d.ts.map +1 -1
  37. package/dist/discover.js +2 -8
  38. package/dist/discover.js.map +1 -1
  39. package/dist/env.d.ts +1 -1
  40. package/dist/env.d.ts.map +1 -1
  41. package/dist/env.js +2 -2
  42. package/dist/env.js.map +1 -1
  43. package/dist/errors.d.ts.map +1 -1
  44. package/dist/errors.js +4 -1
  45. package/dist/errors.js.map +1 -1
  46. package/dist/index.d.ts +1 -1
  47. package/dist/index.d.ts.map +1 -1
  48. package/dist/index.js.map +1 -1
  49. package/dist/modelAdapters.d.ts +1 -1
  50. package/dist/modelAdapters.d.ts.map +1 -1
  51. package/dist/modelAdapters.js +20 -4
  52. package/dist/modelAdapters.js.map +1 -1
  53. package/dist/notices.js.map +1 -1
  54. package/dist/ollama.js.map +1 -1
  55. package/dist/openai.js.map +1 -1
  56. package/dist/pi-transport.d.ts +6 -3
  57. package/dist/pi-transport.d.ts.map +1 -1
  58. package/dist/pi-transport.js +304 -49
  59. package/dist/pi-transport.js.map +1 -1
  60. package/dist/promptTokens.js.map +1 -1
  61. package/dist/provider-env.js.map +1 -1
  62. package/dist/providerError.js.map +1 -1
  63. package/dist/reasoning-effort.js.map +1 -1
  64. package/dist/retry-deadline.d.ts.map +1 -1
  65. package/dist/retry-deadline.js +10 -14
  66. package/dist/retry-deadline.js.map +1 -1
  67. package/dist/stream-forensics.d.ts.map +1 -1
  68. package/dist/stream-forensics.js +173 -25
  69. package/dist/stream-forensics.js.map +1 -1
  70. package/dist/types.d.ts +10 -1
  71. package/dist/types.d.ts.map +1 -1
  72. package/dist/types.js.map +1 -1
  73. package/dist/usage.js.map +1 -1
  74. package/dist/warnings.js.map +1 -1
  75. package/docs/models.md +9 -15
  76. package/package.json +6 -6
@@ -1 +1 @@
1
- {"version":3,"file":"warnings.js","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yFAAyF;AACzF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,IAAY,EAAQ,EAAE;IACnE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,cAAc,GAAI,UAEtB,CAAC,OAAO,CAAC;IACX,IAAI,cAAc,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5C,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;AACL,CAAC,CAAC;AAEF,mFAAmF;AACnF,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAS,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"warnings.js","sourceRoot":"","sources":["../src/warnings.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,yFAAyF;AACzF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,2EAA2E;AAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,IAAY,EAAQ,EAAE;IACnE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACjC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,MAAM,cAAc,GAAI,UAEtB,CAAC,OAAO,CAAC;IACX,IAAI,cAAc,EAAE,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5C,cAAc,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;SAAM,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;AACL,CAAC,CAAC;AAEF,mFAAmF;AACnF,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAS,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC","sourcesContent":["// Process-lifetime warning dedup (#40). Operator-facing warnings (estimated\n// prompt measurement, failed probe, unknown context) fire on EVERY provider construction\n// — a daemon that builds providers per aliased run repeats them until operators\n// tune them out. Dedup key is (code, message), NOT code alone: the messages name\n// the provider/model, and collapsing on code would suppress a SECOND provider's\n// first (and only) surfacing — an operator reading \"openai is heuristic\" would\n// wrongly conclude groq is exact. Same (code, message) → once per process.\nconst emitted = new Set<string>();\n\nexport const emitWarningOnce = (message: string, code: string): void => {\n const key = `${code}\u0000${message}`;\n if (emitted.has(key)) return;\n emitted.add(key);\n const runtimeProcess = (globalThis as {\n process?: { emitWarning?: (warning: string, options: { code: string }) => void };\n }).process;\n if (runtimeProcess?.emitWarning !== undefined) {\n runtimeProcess.emitWarning(message, { code });\n } else {\n console.warn(`[${code}] ${message}`);\n }\n};\n\n// Test-only: clear the dedup set so warning-asserting tests stay order-independent\n// (same shape as resetDiscoveryCache).\nexport const resetEmittedWarnings = (): void => { emitted.clear(); };\n"]}
package/docs/models.md CHANGED
@@ -1,19 +1,13 @@
1
1
  # Models and generation
2
2
 
3
- A route is `provider/model`; an alias names a route with its own tuning. The
4
- session owns its model and reasoning selection: an explicit selection persists
5
- on the session, a loop snapshots the resolved route, and a change to the
6
- daemon's default does not retarget an existing session. A child session runs on
7
- its parent's durable spawn selection, else the parent's own model.
3
+ ## Summary
8
4
 
9
- Effort and budget are independent. The effort names available come from the
10
- selected route, and an unsupported request is refused rather than downgraded.
11
- Output accepts a token count or a percentage of context, capped by the model's
12
- known limits; a reasoning budget, when set, is smaller than the total output,
13
- and leaving it unset does not disable reasoning. Context is derived from the
14
- endpoint or the catalog; an operator cap can only shrink it.
5
+ Configure model aliases, provider routes, credentials, reasoning effort, context/output budgets, and caching.
15
6
 
16
- Cost is an estimate from known usage and catalog rates unless the provider
17
- reports a settled charge. A timeout is a failure, never a fabricated response;
18
- an interrupted call is reissued within the loop's recovery window, after which
19
- the loop parks for a prompt or a wake.
7
+ | Aspect | Contract |
8
+ | --- | --- |
9
+ | Route & alias | A route is `provider/model`; `PLURNK_MODEL_<alias>` binds a route and its per-alias tuning knobs. |
10
+ | Session selection | Explicit model and effort selections persist on the session; a loop snapshots the resolved route; child sessions inherit the parent's spawn model (`PLURNK_MODEL_CHILD`) or the parent's own model. |
11
+ | Effort & output budget | Effort levels come from the selected route (unsupported levels are refused, never downgraded). Output budget accepts tokens or a context percentage; reasoning budget, when set, must be smaller than total output. |
12
+ | Context window | Derived from the endpoint or catalog; an operator cap (`PLURNK_PROVIDERS_CONTEXT_WINDOW`) can only shrink it. |
13
+ | Cost & recovery | Cost uses settled provider charges when reported, else catalog rates. Timeouts fail honestly; interrupted calls retry within the recovery window before parking for a prompt or wake. |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plurnk/plurnk-providers",
3
- "version": "6.0.3",
3
+ "version": "6.1.1",
4
4
  "description": "PLURNK's stable model-provider contract and provider SDK adapter.",
5
5
  "keywords": [
6
6
  "plurnk",
@@ -10,7 +10,7 @@
10
10
  ],
11
11
  "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-providers#readme",
12
12
  "bugs": {
13
- "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
13
+ "url": "https://github.com/plurnk/plurnk-service/issues"
14
14
  },
15
15
  "repository": {
16
16
  "type": "git",
@@ -66,14 +66,14 @@
66
66
  "prepack": "npm run build"
67
67
  },
68
68
  "dependencies": {
69
- "@earendil-works/pi-ai": "1.5.0",
69
+ "@earendil-works/pi-ai": "1.5.2",
70
70
  "@plurnk/plurnk-aliases": "^2.0.0",
71
- "@plurnk/plurnk-contracts": "^7.2.0",
72
- "@plurnk/plurnk-meta": "^2.1.0",
71
+ "@plurnk/plurnk-contracts": "^7.4.0",
72
+ "@plurnk/plurnk-meta": "^2.2.0",
73
73
  "@plurnk/plurnk-models": "^4.0.0"
74
74
  },
75
75
  "devDependencies": {
76
76
  "esbuild": "^0.28.2"
77
77
  },
78
- "gitHead": "90ac58d2bcc0db5459dfc60093c511a9ee7b8313"
78
+ "gitHead": "49f92d9351021ae0729d69e72ab9b1b95e3a974b"
79
79
  }