arcane-os 0.5.10 → 0.5.12

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 (54) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/README.md +117 -26
  3. package/browser-runtime/ai/browser-speech-providers.mjs +1 -1
  4. package/docs/architecture.md +303 -0
  5. package/docs/compatibility.md +38 -0
  6. package/docs/event-manager.md +263 -0
  7. package/docs/platform-targets.md +104 -0
  8. package/docs/publishing.md +126 -0
  9. package/docs/reference/README.md +206 -0
  10. package/docs/reference/ai/browser-speech.md +879 -0
  11. package/docs/reference/ai/browser-wasm.md +637 -0
  12. package/docs/reference/ai/twin-cloud.md +156 -0
  13. package/docs/reference/arcane-ollama.md +288 -0
  14. package/docs/reference/availability-and-normalization.md +224 -0
  15. package/docs/reference/behavioral-testing.md +129 -0
  16. package/docs/reference/cli.md +820 -0
  17. package/docs/reference/core/README.md +61 -0
  18. package/docs/reference/core/arcane-ai-contracts.md +906 -0
  19. package/docs/reference/core/arcane-api.md +601 -0
  20. package/docs/reference/core/arcane-entities.md +59 -0
  21. package/docs/reference/core/arcane-events.md +134 -0
  22. package/docs/reference/core/ollama-module.md +181 -0
  23. package/docs/reference/core/reference/arcane-api/ai-and-ollama.md +1909 -0
  24. package/docs/reference/core/reference/arcane-api/applications-terminal-capabilities.md +1057 -0
  25. package/docs/reference/core/reference/arcane-api/core-and-events.md +320 -0
  26. package/docs/reference/core/reference/arcane-api/filesystem-storage-preferences-appearance.md +610 -0
  27. package/docs/reference/core/reference/arcane-api/namespaces.md +1157 -0
  28. package/docs/reference/core/reference/arcane-api/platform-installation-users-system.md +1423 -0
  29. package/docs/reference/core/reference/arcane-api/session-provisioning-diagnostics-development.md +315 -0
  30. package/docs/reference/event-manager.md +1409 -0
  31. package/docs/reference/inventory/package-api.json +3194 -0
  32. package/docs/reference/inventory/runtime-components.json +1015 -0
  33. package/docs/reference/inventory/runtime-entities.json +25 -0
  34. package/docs/reference/inventory/runtime-modules.json +1367 -0
  35. package/docs/reference/mail.md +309 -0
  36. package/docs/reference/protocols.md +749 -0
  37. package/docs/reference/runtime-components.md +1532 -0
  38. package/docs/reference/runtime-entities.md +305 -0
  39. package/docs/reference/runtime-modules.md +3310 -0
  40. package/docs/reference/sdk-api.md +6733 -0
  41. package/docs/roadmap.md +79 -0
  42. package/docs/work-amplification.md +66 -0
  43. package/examples/wasm-ai-demo/README.md +80 -0
  44. package/examples/wasm-ai-demo/app.js +787 -0
  45. package/examples/wasm-ai-demo/index.html +343 -0
  46. package/examples/wasm-ai-demo/profile-tools.js +217 -0
  47. package/examples/wasm-ai-demo/profiles/BOSS.Modelfile +106 -0
  48. package/examples/wasm-ai-demo/profiles/PreCrisis.Modelfile +693 -0
  49. package/examples/wasm-ai-demo/rag/boss-library.json +3006 -0
  50. package/examples/wasm-ai-demo/rag.js +295 -0
  51. package/examples/wasm-ai-demo/server.mjs +71 -0
  52. package/package.json +10 -1
  53. package/runtime/arcane/modules/AI.js +60 -11
  54. package/runtime/arcane/modules/AIProviderRuntime.js +26 -5
package/docs/reference/core/README.md ADDED
@@ -0,0 +1,61 @@
1
+ # Arcane Core reference snapshot
2
+
3
+ This directory derives the complete committed Arcane application API reference
4
+ from the SDK runtime's exact upstream Arcane OS commit
5
+ `567ad110bf57a1c2d4a3daa22ae93716cc5f4d7e`. The imported reference defines
6
+ protocol `arcane/1` at that source identity. Its canonical inventories and
7
+ focused member contracts were imported from committed Arcane OS `main` commit
8
+ `13f3ce0ae34f77a3495331c8b4c30b1bb105f8ed`. SDK-local links and
9
+ package-boundary annotations are intentionally added here, so the imported
10
+ Markdown remains a maintained SDK reference rather than a second runtime
11
+ authority.
12
+
13
+ The snapshot contains:
14
+
15
+ - 35 namespaces, constructors, and values;
16
+ - 106 application-facing methods;
17
+ - 14 renderer-visible event names;
18
+ - 29 public shared-entity exports;
19
+ - the complete provider-neutral AI and direct Ollama data contracts;
20
+ - 141 MDN-style member guides with exact H2 keys, substantive contract detail,
21
+ and safe JavaScript examples.
22
+
23
+ ## Canonical files
24
+
25
+ | Contract | File |
26
+ | --- | --- |
27
+ | Namespace and method inventory | [Arcane API reference](arcane-api.md) |
28
+ | Event names, delivery, hosts, triggers, and payloads | [Arcane events](arcane-events.md) |
29
+ | Public entity exports | [Arcane entities](arcane-entities.md) |
30
+ | AI requests, results, bounds, and provider boundaries | [Arcane AI data contracts](arcane-ai-contracts.md) |
31
+ | Ollama runtime/module overview | [Ollama module](ollama-module.md) |
32
+ | Per-member guides | [`reference/arcane-api/`](reference/arcane-api/) |
33
+
34
+ ## Runtime source and Core compatibility
35
+
36
+ The SDK's browser runtime and this source reference use the same selected Arcane
37
+ OS source commit, but they remain different artifact classes. A native build
38
+ does not infer compatibility from a higher Core version or a matching protocol
39
+ name. It compares the protocol, version, features, capabilities, methods, and
40
+ provider contract required by the selected build. That present-build result is
41
+ not a promise that a future SDK will accept this Core or that this SDK will
42
+ accept a future Core.
43
+
44
+ Documentation does not select a Core. The selected native plan and provider
45
+ contracts remain authoritative for a particular build.
46
+
47
+ ## Reading order
48
+
49
+ Application developers should begin with the capability or method in
50
+ [Arcane API reference](arcane-api.md) and use its linked guide. Engineers who
51
+ need WebView2, WebKitGTK, Android WebView, development HTTP, Core RPC, event,
52
+ or provider boundaries can continue into the SDK's
53
+ [protocol and host architecture guide](../protocols.md).
54
+
55
+ ## Source and license links
56
+
57
+ - [Pinned upstream ARCANE-OS source](https://github.com/TheWizardNexus/ARCANE-OS/tree/567ad110bf57a1c2d4a3daa22ae93716cc5f4d7e)
58
+ - [SDK runtime source](../../../runtime/arcane)
59
+ - [AGPL license](../../../LICENSE)
60
+ - [Commercial-license notice](../../../COMMERCIAL-LICENSE.md)
61
+ - [Third-party and distribution notice](../../../NOTICE)