@octopi-agent/engine 0.98.4 → 0.102.10
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.
- package/dist/config-schema/agent.d.ts +35 -5
- package/dist/config-schema/agent.js +24 -4
- package/dist/config-schema/context.d.ts +6 -36
- package/dist/config-schema/context.js +4 -28
- package/dist/config-schema/engine.d.ts +57 -160
- package/dist/config-schema/engine.js +1 -5
- package/dist/config-schema/governance.d.ts +8 -1
- package/dist/config-schema/governance.js +8 -1
- package/dist/config-schema/models.d.ts +2 -8
- package/dist/config-schema/models.js +0 -2
- package/dist/config-schema/run.d.ts +2 -2
- package/dist/config-schema/run.js +2 -2
- package/dist/config-schema/shared.d.ts +0 -3
- package/dist/config-schema/shared.js +0 -2
- package/dist/config-schema/substrate.d.ts +14 -88
- package/dist/config-schema/substrate.js +22 -107
- package/dist/config.d.ts +45 -113
- package/dist/config.js +8 -2
- package/dist/harness/activation/dispatcher.js +7 -0
- package/dist/harness/activation/inbox.d.ts +3 -3
- package/dist/harness/activation/inbox.js +3 -3
- package/dist/harness/activation/runtime.js +13 -5
- package/dist/harness/activation/types.d.ts +2 -2
- package/dist/harness/agent/builder.d.ts +24 -3
- package/dist/harness/agent/builder.js +131 -27
- package/dist/harness/agent/config-bridge.js +9 -2
- package/dist/harness/agent/config-integrity.js +19 -2
- package/dist/harness/agent/wire-agent-builder.d.ts +11 -3
- package/dist/harness/agent/wire-agent-builder.js +26 -7
- package/dist/harness/capabilities/document/factory.d.ts +5 -0
- package/dist/harness/capabilities/document/factory.js +1 -0
- package/dist/harness/capabilities/document/port.js +6 -3
- package/dist/harness/capabilities/document/types.d.ts +5 -0
- package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
- package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
- package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +1 -1
- package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +3 -3
- package/dist/harness/collaboration/delegation/child-run.d.ts +1 -1
- package/dist/harness/collaboration/delegation/child-run.js +4 -4
- package/dist/harness/collaboration/delegation/index.d.ts +1 -1
- package/dist/harness/collaboration/delegation/index.js +1 -1
- package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
- package/dist/harness/collaboration/delegation/notifier.js +8 -1
- package/dist/harness/collaboration/delegation/service.d.ts +2 -0
- package/dist/harness/collaboration/delegation/service.js +2 -1
- package/dist/harness/collaboration/delegation/store.d.ts +2 -0
- package/dist/harness/collaboration/delegation/store.js +2 -1
- package/dist/harness/collaboration/delegation/types.d.ts +23 -2
- package/dist/harness/collaboration/delegation/types.js +22 -0
- package/dist/harness/collaboration/delegation/wiring.js +11 -1
- package/dist/harness/context/budget-allocator.d.ts +26 -18
- package/dist/harness/context/budget-allocator.js +67 -32
- package/dist/harness/context/capabilities/compact/engine.d.ts +0 -6
- package/dist/harness/context/capabilities/compact/engine.js +169 -121
- package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
- package/dist/harness/context/capabilities/compact/handover.js +7 -5
- package/dist/harness/context/capabilities/compact/index.d.ts +5 -1
- package/dist/harness/context/capabilities/compact/index.js +4 -0
- package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
- package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
- package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
- package/dist/harness/context/capabilities/compact/messages.js +91 -0
- package/dist/harness/context/capabilities/compact/types.d.ts +76 -11
- package/dist/harness/context/capabilities/compact/types.js +11 -1
- package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
- package/dist/harness/context/capabilities/compact/view-split.js +72 -0
- package/dist/harness/context/capabilities/summary/port.js +0 -1
- package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/resolver.js +1 -6
- package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
- package/dist/harness/context/capabilities/summary/types.d.ts +3 -6
- package/dist/harness/context/context-size-ledger.d.ts +143 -0
- package/dist/harness/context/context-size-ledger.js +236 -0
- package/dist/harness/context/default-context-engine.d.ts +195 -119
- package/dist/harness/context/default-context-engine.js +1241 -743
- package/dist/harness/context/index.d.ts +2 -2
- package/dist/harness/context/index.js +1 -1
- package/dist/harness/context/layer-types.d.ts +15 -0
- package/dist/harness/context/layer-types.js +14 -1
- package/dist/harness/context/layers.d.ts +14 -15
- package/dist/harness/context/layers.js +41 -11
- package/dist/harness/context/message-selector.d.ts +10 -8
- package/dist/harness/context/message-selector.js +49 -27
- package/dist/harness/context/summarize.d.ts +2 -2
- package/dist/harness/context/summarize.js +9 -2
- package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
- package/dist/harness/context/system-prompt-assembler.js +2 -1
- package/dist/harness/context/token-constants.d.ts +8 -6
- package/dist/harness/context/token-constants.js +8 -7
- package/dist/harness/context/token-estimate-fns.d.ts +37 -27
- package/dist/harness/context/token-estimate-fns.js +85 -66
- package/dist/harness/context/token-estimator.d.ts +27 -12
- package/dist/harness/context/token-estimator.js +120 -66
- package/dist/harness/context/token-segments.d.ts +88 -0
- package/dist/harness/context/token-segments.js +103 -0
- package/dist/harness/context/tool-result-aging.d.ts +6 -1
- package/dist/harness/context/tool-result-aging.js +16 -5
- package/dist/harness/context/tool-result-body.js +2 -0
- package/dist/harness/context/transform/anchors.d.ts +66 -0
- package/dist/harness/context/transform/anchors.js +125 -0
- package/dist/harness/context/transform/fold.d.ts +56 -0
- package/dist/harness/context/transform/fold.js +135 -0
- package/dist/harness/context/transform/migrate.d.ts +41 -0
- package/dist/harness/context/transform/migrate.js +69 -0
- package/dist/harness/context/transform/types.d.ts +129 -0
- package/dist/harness/context/transform/types.js +19 -0
- package/dist/harness/context/turn-envelope.d.ts +6 -3
- package/dist/harness/context/types.d.ts +127 -117
- package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
- package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
- package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
- package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
- package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
- package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
- package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
- package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
- package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
- package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +83 -249
- package/dist/harness/extension/plugin-ecosystem/plugins/api.js +88 -214
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +43 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +61 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
- package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
- package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +50 -117
- package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +316 -285
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +23 -490
- package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +85 -353
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +41 -223
- package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +138 -19
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +15 -0
- package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
- package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
- package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
- package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
- package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -8
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
- package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
- package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +11 -2
- package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
- package/dist/harness/governance/accounting/usage-ledger.js +23 -1
- package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
- package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
- package/dist/harness/governance/security/capability-enforcer.js +1 -2
- package/dist/harness/index.d.ts +12 -12
- package/dist/harness/index.js +7 -7
- package/dist/harness/knowledge/boot-config.d.ts +55 -0
- package/dist/harness/knowledge/boot-config.js +50 -0
- package/dist/harness/knowledge/catalog-types.d.ts +2 -0
- package/dist/harness/knowledge/client.d.ts +24 -2
- package/dist/harness/knowledge/client.js +19 -5
- package/dist/harness/knowledge/db.js +5 -0
- package/dist/harness/knowledge/describe-sample.d.ts +23 -0
- package/dist/harness/knowledge/describe-sample.js +58 -0
- package/dist/harness/knowledge/describe.d.ts +8 -0
- package/dist/harness/knowledge/describe.js +18 -2
- package/dist/harness/knowledge/engine-thread.js +6 -0
- package/dist/harness/knowledge/grounding.js +3 -1
- package/dist/harness/knowledge/http-app.js +35 -4
- package/dist/harness/knowledge/http-params.d.ts +18 -0
- package/dist/harness/knowledge/http-params.js +24 -0
- package/dist/harness/knowledge/index.d.ts +2 -0
- package/dist/harness/knowledge/index.js +1 -0
- package/dist/harness/knowledge/knowledge-serve-child.js +3 -0
- package/dist/harness/knowledge/purge.js +5 -2
- package/dist/harness/knowledge/query-service.d.ts +13 -2
- package/dist/harness/knowledge/query-service.js +4 -2
- package/dist/harness/knowledge/query-worker-client.d.ts +9 -1
- package/dist/harness/knowledge/query-worker-client.js +4 -2
- package/dist/harness/knowledge/query-worker.js +4 -2
- package/dist/harness/knowledge/read-http.js +5 -1
- package/dist/harness/knowledge/serve.d.ts +8 -7
- package/dist/harness/knowledge/serve.js +9 -0
- package/dist/harness/knowledge/source-store.js +26 -3
- package/dist/harness/knowledge/start-service-process.d.ts +15 -7
- package/dist/harness/knowledge/start-service-process.js +21 -9
- package/dist/harness/knowledge/types.d.ts +7 -0
- package/dist/harness/knowledge/writer-service.d.ts +37 -9
- package/dist/harness/knowledge/writer-service.js +120 -14
- package/dist/harness/knowledge/writer-worker-client.d.ts +10 -9
- package/dist/harness/knowledge/writer-worker-client.js +20 -2
- package/dist/harness/knowledge/writer-worker.js +9 -1
- package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
- package/dist/harness/memory/types.d.ts +6 -4
- package/dist/harness/memory/wisdom-formation.d.ts +14 -3
- package/dist/harness/memory/wisdom-formation.js +85 -22
- package/dist/harness/memory/wisdom-gates.d.ts +14 -0
- package/dist/harness/memory/wisdom-gates.js +59 -19
- package/dist/harness/memory/wisdom.js +9 -0
- package/dist/harness/observability/observer/hub.js +25 -15
- package/dist/harness/observability/observer/types.d.ts +10 -6
- package/dist/harness/run/agent/agent.d.ts +40 -21
- package/dist/harness/run/agent/agent.js +66 -13
- package/dist/harness/run/agent/index.d.ts +1 -1
- package/dist/harness/run/budget/budget.d.ts +28 -10
- package/dist/harness/run/budget/budget.js +38 -15
- package/dist/harness/run/model/index.d.ts +3 -1
- package/dist/harness/run/model/index.js +2 -1
- package/dist/harness/run/model/resolver.d.ts +4 -1
- package/dist/harness/run/model/resolver.js +36 -2
- package/dist/harness/run/model/run-scope.d.ts +2 -0
- package/dist/harness/run/model/run-scope.js +7 -0
- package/dist/harness/run/model/types.d.ts +22 -5
- package/dist/harness/run/model/types.js +3 -2
- package/dist/harness/run/model/window-truth.d.ts +37 -0
- package/dist/harness/run/model/window-truth.js +39 -0
- package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
- package/dist/harness/run/reliability/context-length-feedback.js +128 -0
- package/dist/harness/run/reliability/harness-events.d.ts +3 -3
- package/dist/harness/run/reliability/model-error-policy.js +4 -0
- package/dist/harness/run/reliability/run-agent.d.ts +10 -4
- package/dist/harness/run/reliability/run-agent.js +137 -53
- package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
- package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
- package/dist/harness/run/run-guard/default-run-guard.js +8 -8
- package/dist/harness/run/run-scope.d.ts +37 -4
- package/dist/harness/run/runner.d.ts +44 -29
- package/dist/harness/run/runner.js +320 -102
- package/dist/harness/session/attachments/index.d.ts +1 -0
- package/dist/harness/session/attachments/index.js +1 -0
- package/dist/harness/session/attachments/inject.d.ts +21 -10
- package/dist/harness/session/attachments/inject.js +76 -24
- package/dist/harness/session/attachments/recall-index.d.ts +70 -0
- package/dist/harness/session/attachments/recall-index.js +219 -0
- package/dist/harness/session/attachments/service.d.ts +21 -0
- package/dist/harness/session/attachments/service.js +258 -139
- package/dist/harness/session/attachments/types.d.ts +6 -0
- package/dist/harness/session/transform-store.d.ts +136 -0
- package/dist/harness/session/transform-store.js +302 -0
- package/dist/harness/session/types.d.ts +2 -2
- package/dist/harness/shared/events/agent-event-map.d.ts +46 -13
- package/dist/harness/shared/events/agent-event-map.js +3 -2
- package/dist/harness/shared/events/scenario-events.d.ts +6 -6
- package/dist/harness/shared/types/agent-definition.d.ts +1 -2
- package/dist/index.d.ts +14 -17
- package/dist/index.js +7 -9
- package/dist/integration/observability/metrics.d.ts +6 -6
- package/dist/integration/observability/metrics.js +13 -13
- package/dist/integration/observability/observer-bridge.js +2 -2
- package/dist/integration/observability/trace-collector.d.ts +5 -5
- package/dist/integration/observability/trace-collector.js +34 -35
- package/dist/integration/observability/trace-events.d.ts +3 -3
- package/dist/integration/observability/trace-events.js +3 -3
- package/dist/integration/providers/anthropic.js +14 -1
- package/dist/integration/providers/openai.js +7 -1
- package/dist/integration/providers/usage.d.ts +1 -1
- package/dist/integration/providers/wire-dump.d.ts +1 -1
- package/dist/integration/storage/archive-manager.d.ts +6 -0
- package/dist/integration/storage/archive-manager.js +10 -0
- package/dist/integration/storage/jsonl.d.ts +1 -1
- package/dist/integration/storage/jsonl.js +18 -16
- package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
- package/dist/subsystems/wisdom-steward/formation/config.yaml +1 -0
- package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
- package/package.json +11 -14
- package/dist/harness/context/hybrid-compressor.d.ts +0 -41
- package/dist/harness/context/hybrid-compressor.js +0 -159
- package/dist/harness/context/llm-summarizer.d.ts +0 -46
- package/dist/harness/context/llm-summarizer.js +0 -249
- package/dist/harness/context/smart-router.d.ts +0 -75
- package/dist/harness/context/smart-router.js +0 -118
- package/dist/harness/context/truncate-compressor.d.ts +0 -28
- package/dist/harness/context/truncate-compressor.js +0 -107
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
- package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
- package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
|
@@ -1,24 +1,7 @@
|
|
|
1
|
-
/**
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
* 核心概念:
|
|
5
|
-
* - Plugin = 能力的所有权边界(Provider/Channel/Tool/Hook 等)
|
|
6
|
-
* - definePluginEntry() = 创建 plugin 的标准方式
|
|
7
|
-
* - PluginApi = plugin register() 回调中接收的 api 对象
|
|
8
|
-
* - PluginManifest = 声明式元数据(octopi.plugin.json)
|
|
9
|
-
* - PluginLoader = 发现和加载 plugins
|
|
10
|
-
* - PluginManager = 管理 plugin 生命周期和 hook 执行
|
|
11
|
-
* - CapabilityRegistry = 能力注册中心
|
|
12
|
-
*/
|
|
13
|
-
export { definePluginEntry, defineChannelPluginEntry } from './entry.js';
|
|
14
|
-
export type { OctopiPluginDefinition, OctopiChannelPluginDefinition } from './entry.js';
|
|
1
|
+
/** Plugin author contract. Host loading and mounting live under ./harness/. */
|
|
2
|
+
export { definePlugin } from './entry.js';
|
|
3
|
+
export type { OctopiPluginDefinition } from './entry.js';
|
|
15
4
|
export { PluginApi } from './api.js';
|
|
16
|
-
export type { PluginLogger,
|
|
17
|
-
export { validateManifest, parseManifest } from './manifest.js';
|
|
18
|
-
export type { PluginManifest,
|
|
19
|
-
export { CapabilityRegistry, registerManifestCapabilities } from './capability.js';
|
|
20
|
-
export type { CapabilityType, CapabilityRecord } from './capability.js';
|
|
21
|
-
export { PluginLoader } from './loader.js';
|
|
22
|
-
export type { LoadedPlugin, PluginLoaderConfig, PluginEntryConfig } from './loader.js';
|
|
23
|
-
export { PluginManager } from './manager.js';
|
|
24
|
-
export type { BeforeModelResolveEvent, AgentTurnPrepareEvent, BeforePromptBuildEvent, BeforeAgentRunEvent, BeforeAgentReplyEvent, BeforeAgentFinalizeEvent, AgentEndEvent, BeforeToolCallEvent, AfterToolCallEvent, MessageReceivedEvent, MessageSendingEvent, MessageSentEvent, SessionLifecycleEvent, CompactionEvent, GatewayLifecycleEvent, BeforeInstallEvent, ModelResolveResult, PromptBuildResult, AgentRunResult, AgentReplyResult, AgentFinalizeResult, ToolCallResult, MessageSendingResult, InstallResult, } from './manager.js';
|
|
5
|
+
export type { PluginLogger, PluginCommandRegistration, PluginCommandContext, PluginHookMap, HookHandler, HookRegistrationOptions, ToolRegistrationOptions, } from './api.js';
|
|
6
|
+
export { PLUGIN_API_VERSION, PLUGIN_HOOK_NAMES, validateManifest, parseManifest, validatePluginConfig, } from './manifest.js';
|
|
7
|
+
export type { PluginManifest, PluginContributions, PluginCommandContribution, PluginHookName, PluginSessionOpName, JsonSchema, } from './manifest.js';
|
|
@@ -1,24 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
|
|
3
|
-
*
|
|
4
|
-
* 核心概念:
|
|
5
|
-
* - Plugin = 能力的所有权边界(Provider/Channel/Tool/Hook 等)
|
|
6
|
-
* - definePluginEntry() = 创建 plugin 的标准方式
|
|
7
|
-
* - PluginApi = plugin register() 回调中接收的 api 对象
|
|
8
|
-
* - PluginManifest = 声明式元数据(octopi.plugin.json)
|
|
9
|
-
* - PluginLoader = 发现和加载 plugins
|
|
10
|
-
* - PluginManager = 管理 plugin 生命周期和 hook 执行
|
|
11
|
-
* - CapabilityRegistry = 能力注册中心
|
|
12
|
-
*/
|
|
13
|
-
// ── 定义和创建 ──
|
|
14
|
-
export { definePluginEntry, defineChannelPluginEntry } from './entry.js';
|
|
15
|
-
// ── Plugin API ──
|
|
1
|
+
/** Plugin author contract. Host loading and mounting live under ./harness/. */
|
|
2
|
+
export { definePlugin } from './entry.js';
|
|
16
3
|
export { PluginApi } from './api.js';
|
|
17
|
-
|
|
18
|
-
export { validateManifest, parseManifest } from './manifest.js';
|
|
19
|
-
// ── Capability Registry ──
|
|
20
|
-
export { CapabilityRegistry, registerManifestCapabilities } from './capability.js';
|
|
21
|
-
// ── Plugin Loader ──
|
|
22
|
-
export { PluginLoader } from './loader.js';
|
|
23
|
-
// ── Plugin Manager ──
|
|
24
|
-
export { PluginManager } from './manager.js';
|
|
4
|
+
export { PLUGIN_API_VERSION, PLUGIN_HOOK_NAMES, validateManifest, parseManifest, validatePluginConfig, } from './manifest.js';
|
|
@@ -1,133 +1,66 @@
|
|
|
1
|
-
/**
|
|
2
|
-
|
|
3
|
-
*
|
|
4
|
-
* 加载流程:
|
|
5
|
-
* 1. Discovery — 从配置路径发现候选 plugins
|
|
6
|
-
* 2. Validation — 验证 manifest、检查 enable/disable 状态
|
|
7
|
-
* 3. Loading — 进程内加载 plugin 代码
|
|
8
|
-
* 4. Registration — 调用 register() 注册能力
|
|
9
|
-
*/
|
|
10
|
-
import type { PluginManifest } from './manifest.js';
|
|
1
|
+
/** Manifest-first discovery: no plugin code runs before eligibility and config validation. */
|
|
2
|
+
import { type PluginManifest } from './manifest.js';
|
|
11
3
|
import type { OctopiPluginDefinition } from './entry.js';
|
|
12
|
-
import type
|
|
13
|
-
import { CapabilityRegistry } from './capability.js';
|
|
14
|
-
/**
|
|
15
|
-
* 加载后的 Plugin 实例
|
|
16
|
-
*/
|
|
17
|
-
export interface LoadedPlugin {
|
|
18
|
-
/** Plugin ID */
|
|
19
|
-
id: string;
|
|
20
|
-
/** Plugin Manifest */
|
|
21
|
-
manifest: PluginManifest;
|
|
22
|
-
/** Plugin 定义(包含 register 回调) */
|
|
23
|
-
definition: OctopiPluginDefinition;
|
|
24
|
-
/** Plugin API 实例 */
|
|
25
|
-
api: PluginApi;
|
|
26
|
-
/** Plugin 源路径 */
|
|
27
|
-
source: string;
|
|
28
|
-
/** Plugin root 目录 */
|
|
29
|
-
rootDir: string;
|
|
30
|
-
/** 是否已执行 register() */
|
|
31
|
-
registered: boolean;
|
|
32
|
-
}
|
|
33
|
-
/**
|
|
34
|
-
* Plugin Loader 配置
|
|
35
|
-
*/
|
|
36
|
-
export interface PluginLoaderConfig {
|
|
37
|
-
/** Plugin 搜索路径列表 */
|
|
38
|
-
loadPaths: string[];
|
|
39
|
-
/** 允许的 plugin IDs(白名单,空 = 全部允许) */
|
|
40
|
-
allowList?: string[];
|
|
41
|
-
/** 禁用的 plugin IDs */
|
|
42
|
-
blockList?: string[];
|
|
43
|
-
/** Plugin 配置 entries */
|
|
44
|
-
pluginEntries?: Record<string, PluginEntryConfig>;
|
|
45
|
-
}
|
|
46
|
-
/**
|
|
47
|
-
* Plugin Entry 配置(来自宿主配置)
|
|
48
|
-
*/
|
|
4
|
+
import { PluginContributionRegistry, type RegisteredPlugin } from './contribution-registry.js';
|
|
49
5
|
export interface PluginEntryConfig {
|
|
50
|
-
/** 是否启用 */
|
|
51
6
|
enabled?: boolean;
|
|
52
|
-
/** Plugin 配置 */
|
|
53
7
|
config?: Record<string, unknown>;
|
|
54
|
-
/** Hook
|
|
8
|
+
/** Per-plugin hook timeout policy; consumed by the Hook adapter (timeouts keyed by hook name). */
|
|
55
9
|
hooks?: {
|
|
56
|
-
/** 全局 hook 超时 */
|
|
57
10
|
timeoutMs?: number;
|
|
58
|
-
/** 按 hook 名称的超时 */
|
|
59
11
|
timeouts?: Record<string, number>;
|
|
60
|
-
/** 超时后是否中断 hook 链(默认 false:跳过并继续) */
|
|
61
|
-
abortOnTimeout?: Record<string, boolean>;
|
|
62
|
-
/** 是否允许 conversation access */
|
|
63
|
-
allowConversationAccess?: boolean;
|
|
64
|
-
/** 是否允许 prompt injection */
|
|
65
|
-
allowPromptInjection?: boolean;
|
|
66
12
|
};
|
|
67
13
|
}
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
14
|
+
export interface PluginLoaderConfig {
|
|
15
|
+
loadPaths: string[];
|
|
16
|
+
allowList?: string[];
|
|
17
|
+
blockList?: string[];
|
|
18
|
+
entries?: Record<string, PluginEntryConfig>;
|
|
19
|
+
engineVersion?: string;
|
|
20
|
+
}
|
|
21
|
+
export type PluginDiagnosticStatus = 'disabled' | 'failed' | 'registered';
|
|
22
|
+
export interface PluginDiagnostic {
|
|
23
|
+
id: string;
|
|
24
|
+
status: PluginDiagnosticStatus;
|
|
25
|
+
stage: 'manifest' | 'policy' | 'dependency' | 'config' | 'entry' | 'import' | 'register' | 'publish';
|
|
26
|
+
reason: string;
|
|
27
|
+
path?: string;
|
|
28
|
+
}
|
|
29
|
+
export interface LoadedPlugin extends RegisteredPlugin {
|
|
30
|
+
id: string;
|
|
31
|
+
name: string;
|
|
32
|
+
version: string;
|
|
33
|
+
description?: string;
|
|
34
|
+
manifest: PluginManifest;
|
|
35
|
+
definition: OctopiPluginDefinition;
|
|
36
|
+
source: 'local' | 'npm';
|
|
37
|
+
registered: true;
|
|
38
|
+
}
|
|
73
39
|
export declare class PluginLoader {
|
|
74
|
-
|
|
75
|
-
private plugins;
|
|
76
|
-
/** Capability Registry */
|
|
77
|
-
readonly capabilities: CapabilityRegistry;
|
|
78
|
-
/** 配置 */
|
|
40
|
+
readonly contributions: PluginContributionRegistry;
|
|
79
41
|
private config;
|
|
42
|
+
private plugins;
|
|
43
|
+
private diagnostics;
|
|
80
44
|
constructor(config: PluginLoaderConfig);
|
|
81
|
-
/**
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
* 扫描所有配置路径,查找包含 octopi.plugin.json 的目录。
|
|
85
|
-
*
|
|
86
|
-
* @returns 加载的 plugin 列表
|
|
87
|
-
*/
|
|
45
|
+
/** Resolve a loaded plugin's configured hook policy, including legacy aliases. */
|
|
46
|
+
getPluginConfig(id: string): PluginEntryConfig | undefined;
|
|
47
|
+
/** Discover, validate and atomically publish the successful plugin set. */
|
|
88
48
|
discover(): Promise<LoadedPlugin[]>;
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
private
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
private
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
*/
|
|
105
|
-
private resolveEntryPoint;
|
|
106
|
-
/**
|
|
107
|
-
* 过滤 plugins(allowlist / blocklist / enabled)
|
|
108
|
-
*/
|
|
109
|
-
private filterPlugins;
|
|
110
|
-
/**
|
|
111
|
-
* 拓扑排序:按依赖关系排列 plugin 顺序
|
|
112
|
-
*
|
|
113
|
-
* 使用 Kahn 算法。被依赖的 plugin 排在前面。
|
|
114
|
-
* 存在循环依赖时,剩余的 plugin 按原始顺序追加并警告。
|
|
115
|
-
*/
|
|
116
|
-
private resolveDependencyOrder;
|
|
117
|
-
/**
|
|
118
|
-
* 执行 plugin 的 register()
|
|
119
|
-
*/
|
|
120
|
-
private registerPlugin;
|
|
121
|
-
/**
|
|
122
|
-
* 获取已加载的 plugin
|
|
123
|
-
*/
|
|
49
|
+
private scanDirectories;
|
|
50
|
+
private readCandidate;
|
|
51
|
+
private addCandidate;
|
|
52
|
+
private applyAliases;
|
|
53
|
+
private isEligible;
|
|
54
|
+
private prepareCandidate;
|
|
55
|
+
private markDependencyFailures;
|
|
56
|
+
private checkDeclaredConflicts;
|
|
57
|
+
private importAndRegister;
|
|
58
|
+
private resolveEntry;
|
|
59
|
+
private assertActualContributions;
|
|
60
|
+
private disabled;
|
|
61
|
+
private fail;
|
|
62
|
+
getDiagnostics(): PluginDiagnostic[];
|
|
63
|
+
getRegisteredIds(): string[];
|
|
124
64
|
getPlugin(id: string): LoadedPlugin | undefined;
|
|
125
|
-
/**
|
|
126
|
-
* 获取所有已加载的 plugins
|
|
127
|
-
*/
|
|
128
65
|
getAllPlugins(): LoadedPlugin[];
|
|
129
|
-
/**
|
|
130
|
-
* 获取所有已注册的 plugin IDs
|
|
131
|
-
*/
|
|
132
|
-
getRegisteredIds(): string[];
|
|
133
66
|
}
|