@praxis-ai/praxis 0.1.0 → 0.1.2

package/dist/agentCore/index.js

@@ -3,40 +3,75 @@
  * 核心目的：为普通开发者暴露稳定的 Agent authoring、manifest compile 和 runtime kernel API。
  * 边界：不把 runtime.* 深层实现文件作为普通 public API。
  */
-import { PromptPack, PraxisAgent, PraxisAgentArchetype, append, compileAgent, endpoint, harness, inspectAgentManifest, loop, mainLoop, markdown, markdownFile, model, modelFleet, overwrite, policy, prepend, replaceLastLines, sandbox, session, statePlane, storage, tool, toolPolicies, tools, validateAgentManifest, } from "./agent_runtimeImplementation/runtimeAgentManifest.js";
-import { createSandboxRuntimeProvider, prepareSandboxRuntime, sandboxRuntimeProviderDescriptor, } from "./agent_runtimeImplementation/runtime.sandboxPlane/sandboxRuntimeProvider.js";
-import { approvalInterfaceEnvelope, createInterfaceEnvelope, eventInterfaceEnvelope, managementInterfaceEnvelope, repairInterfaceEnvelope, stateInterfaceEnvelope, } from "./agent_interfaceAdapter/interfaceEnvelope.js";
-import { createInterfaceAdapterRuntime, } from "./agent_runtimeImplementation/runtime.interfaceAdapter/interfaceAdapterRuntime.js";
-import { bindBasicInterfaceLayer, } from "./agent_runtimeImplementation/runtime.interfaceAdapter/bindBasicInterfaceLayer.js";
-import { applyRaxStorageInitPlan, createAndApplyStoragePlaneRuntime, createRaxStorageLayout, createStoragePlaneRuntime, planRaxStorageInit, resolveRaxHome, resolveRaxWorkspace, } from "./agent_runtimeImplementation/runtime.storagePlane/storagePlaneRuntime.js";
-import { PraxisRuntimeKernel, createPraxisRuntimeKernel, } from "./agent_runtimeImplementation/praxisRuntimeKernel.js";
-import { createInMemorySessionStateEventStore, } from "./agent_runtimeImplementation/runtimeSessionStateEventStore.js";
-import { createFrameworkInspectionReport, } from "./agent_runtimeImplementation/runtime.inspection/frameworkInspectionReport.js";
-import { baseToolDeveloperCatalogDescriptor, baseTools, listBaseToolDeveloperCatalog, toolSets, tryBaseToolById, } from "./agent_runtimeImplementation/runtime.execEngine/baseToolDeveloperCatalog.js";
-import { baseToolRealityLedgerDescriptor, createBaseToolRealityLedger, inspectBaseToolReality, snapshotBaseToolRealityLedger, } from "./agent_runtimeImplementation/runtime.execEngine/baseToolRealityLedger.js";
-import { adjudicateRuntimeDecision, createLoopTick, createMainLoopCheckpoint, createMainLoopRun, createMainLoopSessionTimeline, createMainLoopStepRecord, createMainLoopTimelineRef, createUserTurn, decideMainLoopFinalAcceptance, exposeMainLoopState, planFrameworkMainLoopHandoff, prepareMainLoopTurn, resolveMainLoopFailureRecovery, resolveMainLoopBudget, runMainLoop, selectMainLoopModel, } from "./agent_executionEngine/coreLogic/mainLoop.js";
-import { interpretModelDecision, } from "./agent_executionEngine/coreLogic/modelDecision.js";
-import { assemblePromptPack, } from "./agent_executionEngine/promptPack/promptAssembler.js";
-import { createFallbackMemoryRef, createObservationMaterial, } from "./agent_executionEngine/coreLogic/observationIntegrator.js";
-export { PromptPack, PraxisAgent, PraxisAgentArchetype, STATE_PLANE_STANDARD_CONTROLS, append, compileAgent, endpoint, harness, inspectAgentManifest, loop, mainLoop, markdown, markdownFile, model, modelFleet, overwrite, policy, prepend, replaceLastLines, sandbox, session, statePlane, storage, tool, toolPolicies, tools, validateAgentManifest, } from "./agent_runtimeImplementation/runtimeAgentManifest.js";
-export { adjudicateRuntimeDecision, analyzeMainLoopCacheHealth, createLoopTick, createMainLoopApprovalEnvelope, createMainLoopBehaviorRegistry, createMainLoopCancelToken, createMainLoopCheckpoint, createMainLoopControlAction, createMainLoopRun, createMainLoopRollbackPoint, createMainLoopSessionTimeline, createMainLoopStepRecord, createMainLoopTimelineRef, createUserTurn, decideMainLoopFinalAcceptance, exposeMainLoopState, planFrameworkMainLoopHandoff, prepareMainLoopTurn, replayMainLoopStep, replayMainLoopTick, replayUserTurn, resolveMainLoopApproval, resolveMainLoopBehaviorRef, resolveMainLoopFailureRecovery, resolveMainLoopBudget, resolveMainLoopBudgetExhaustion, resolveMainLoopContinuation, resolveMainLoopToolChoice, runMainLoop, selectMainLoopModel, DEFAULT_MAIN_LOOP_BUDGET, DEFAULT_MAIN_LOOP_FAILURE_RECOVERY_POLICY, MAIN_LOOP_CONTROL_PRIMITIVES, } from "./agent_executionEngine/coreLogic/mainLoop.js";
-export { interpretModelDecision, } from "./agent_executionEngine/coreLogic/modelDecision.js";
-export { DEFAULT_OBSERVATION_COMPRESSION_POLICY, DEFAULT_OBSERVATION_SUMMARY_DELEGATION_POLICY, DEFAULT_SUMMARY_AGENT_REF, DEFAULT_TOOL_RESULT_SIZE_POLICY, createFallbackMemoryRef, createObservationMaterial, } from "./agent_executionEngine/coreLogic/observationIntegrator.js";
-export { createEphemeralProcedureExecutionState, normalizeEphemeralProcedurePlan, } from "./agent_executionEngine/coreLogic/ephemeralProcedure.js";
-export { assemblePromptPack, } from "./agent_executionEngine/promptPack/promptAssembler.js";
-export { PROMPT_PACK_PROVIDER_VISIBLE_SEGMENT_KINDS, PROMPT_PACK_SEGMENT_KINDS, inferPromptPackSegmentKind, } from "./agent_executionEngine/promptPack/promptDefiner.js";
-export { createSandboxRuntimeProvider, prepareSandboxRuntime, sandboxRuntimeProviderDescriptor, } from "./agent_runtimeImplementation/runtime.sandboxPlane/sandboxRuntimeProvider.js";
-export { approvalInterfaceEnvelope, createInterfaceEnvelope, eventInterfaceEnvelope, managementInterfaceEnvelope, repairInterfaceEnvelope, stateInterfaceEnvelope, } from "./agent_interfaceAdapter/interfaceEnvelope.js";
-export { bindBasicInterfaceLayer, } from "./agent_runtimeImplementation/runtime.interfaceAdapter/bindBasicInterfaceLayer.js";
-export { createInterfaceAdapterRuntime, } from "./agent_runtimeImplementation/runtime.interfaceAdapter/interfaceAdapterRuntime.js";
-export { applyRaxStorageInitPlan, createAndApplyStoragePlaneRuntime, createRaxStorageLayout, createStoragePlaneRuntime, planRaxStorageInit, resolveRaxHome, resolveRaxWorkspace, } from "./agent_runtimeImplementation/runtime.storagePlane/storagePlaneRuntime.js";
-export { PraxisRuntimeKernel, createPraxisRuntimeKernel, } from "./agent_runtimeImplementation/praxisRuntimeKernel.js";
-export { createInMemorySessionStateEventStore, } from "./agent_runtimeImplementation/runtimeSessionStateEventStore.js";
-export { bindRaxodeRoleModel, createRaxodeModelEntry, createRaxodeProviderProfile, createRaxodeSecret, maskRaxodeSecret, resolveRaxodeProviderRequestUrl, } from "./agent_modelAdapter/authProfileLayer/providerConfiguration.js";
-export { createFrameworkInspectionReport, } from "./agent_runtimeImplementation/runtime.inspection/frameworkInspectionReport.js";
-export { baseToolDeveloperCatalogDescriptor, baseTools, listBaseToolDeveloperCatalog, toolSets, tryBaseToolById, } from "./agent_runtimeImplementation/runtime.execEngine/baseToolDeveloperCatalog.js";
-export { baseToolRealityLedgerDescriptor, createBaseToolRealityLedger, inspectBaseToolReality, snapshotBaseToolRealityLedger, } from "./agent_runtimeImplementation/runtime.execEngine/baseToolRealityLedger.js";
-export { createProviderToolMappings, createPraxisToolDeclarations, lowerPraxisToolsForProvider, lowerProviderToolResult, normalizeProviderInputSchema, providerToolName, raiseProviderToolCalls, } from "./agent_modelAdapter/bridgingLayer/toolSchemaCompatibilityLayer.js";
+import { PromptPack, PraxisAgent, PraxisAgentArchetype, append, compileAgent, endpoint, harness, inspectAgentManifest, loop, mainLoop, markdown, markdownFile, model, modelFleet, overwrite, policy, prepend, replaceLastLines, sandbox, session, statePlane, storage, tool, toolPolicies, tools, validateAgentManifest, } from "../runtimeImplementation/runtimeAgentManifest.js";
+import { createSandboxRuntimeProvider, prepareSandboxRuntime, resolveRaxcellBinaryPath, sandboxRuntimeProviderDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/sandboxRuntimeProvider.js";
+import { createSandboxCommandPlan, createLocalSandboxRemoteWorkerAdapter, runSandboxCommand, sandboxCommandRunnerDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/sandboxCommandRunner.js";
+import { createRaxcellSandboxProvider, mapSandboxProviderRequestToRaxcell, raxcellSandboxProviderDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/raxcellSandboxProvider.js";
+import { runSandboxPolicyMiddleware, sandboxPolicyMiddlewareDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/sandboxPolicyMiddleware.js";
+import { approvalInterfaceEnvelope, createInterfaceEnvelope, eventInterfaceEnvelope, managementInterfaceEnvelope, repairInterfaceEnvelope, stateInterfaceEnvelope, } from "../interfaceAdapter/interfaceEnvelope.js";
+import { createInterfaceAdapterRuntime, } from "../runtimeImplementation/runtime.interfaceAdapter/interfaceAdapterRuntime.js";
+import { bindBasicInterfaceLayer, } from "../runtimeImplementation/runtime.interfaceAdapter/bindBasicInterfaceLayer.js";
+import { applyRaxStorageInitPlan, createAndApplyStoragePlaneRuntime, createRaxStorageLayout, createStoragePlaneRuntime, planRaxStorageInit, resolveRaxHome, resolveRaxWorkspace, } from "../runtimeImplementation/runtime.storagePlane/storagePlaneRuntime.js";
+import { openPraxisProject, project as defineProject, projectDescriptor, } from "../runtimeImplementation/runtime.projectPlane/index.js";
+import { createPraxisSessionManager, } from "../runtimeImplementation/runtime.sessionPlane/index.js";
+import { createPraxisConversationManager, } from "../runtimeImplementation/runtime.conversationPlane/index.js";
+import { capabilities, capability, createProvisionPlan, dependencies, dependencyAuthoring, provisionRuntimeDescriptor, } from "../runtimeImplementation/runtime.provisionPlane/index.js";
+import { component, createRuntimeComponentRegistry, lookupRuntimeComponent, officialRuntimeComponents, } from "../runtimeImplementation/runtime.componentPlane/index.js";
+import { canonicalDependencyId, createDependencySourceRegistry, defaultManagedRoot, ensureDependencyAvailable, lookupDependencySource, officialDependencySources, planDependencyInstallation, probeDependency, } from "../runtimeImplementation/runtime.dependencyPlane/index.js";
+import { PraxisRuntimeKernel, createPraxisRuntimeKernel, } from "../runtimeImplementation/praxisRuntimeKernel.js";
+import { createInMemorySessionStateEventStore, } from "../runtimeImplementation/runtimeSessionStateEventStore.js";
+import { createFrameworkInspectionReport, } from "../runtimeImplementation/runtime.inspection/frameworkInspectionReport.js";
+import { baseToolDeveloperCatalogDescriptor, baseToolCodingCoreDescriptor, basetool, baseToolProfile, createBaseToolRegistry, createBaseToolSupportCatalog, evaluateBaseToolRuntimeReadiness, listBaseToolDeveloperCatalog, listBaseToolProfiles, toolSets, tryBaseToolById, } from "../runtimeImplementation/runtime.execEngine/baseToolDeveloperCatalog.js";
+import { baseToolRealityLedgerDescriptor, createBaseToolRealityLedger, inspectBaseToolReality, snapshotBaseToolRealityLedger, } from "../runtimeImplementation/runtime.execEngine/baseToolRealityLedger.js";
+import { adjudicateRuntimeDecision, createLoopTick, createMainLoopCheckpoint, createMainLoopRun, createMainLoopSessionTimeline, createMainLoopStepRecord, createMainLoopTimelineRef, createUserTurn, decideMainLoopFinalAcceptance, exposeMainLoopState, planFrameworkMainLoopHandoff, prepareMainLoopTurn, resolveMainLoopFailureRecovery, resolveMainLoopBudget, runMainLoop, selectMainLoopModel, } from "../executionEngine/coreLogic/mainLoop.js";
+import { interpretModelDecision, } from "../executionEngine/coreLogic/modelDecision.js";
+import { createContextCompactionPipelineExecutor, createLocalSummaryCompactExecutor, createRuntimeFallbackCompactExecutor, decideTurnBoundaryCompact, } from "../executionEngine/coreLogic/contextCompact.js";
+import { assemblePromptPack, } from "../executionEngine/promptPack/promptAssembler.js";
+import { assemblePromptContextMaterials, promptPackMaterialsForManifest, } from "../runtimeImplementation/runtime.execEngine/promptContextAssembly.js";
+import { createObservationMaterial, } from "../executionEngine/coreLogic/observationIntegrator.js";
+import { runtimeAuth, } from "../runtimeImplementation/runtime.authPlane/index.js";
+import { createMemoryPlane, memoryPlane, } from "../memory_managementPool/index.js";
+import { buildMcpServerProfilesFromManifest, createMcpApplicationStateView, mcp, planMcpHarnessExposure, } from "../runtimeImplementation/runtime.mcpPlane/index.js";
+export { PromptPack, PraxisAgent, PraxisAgentArchetype, STATE_PLANE_STANDARD_CONTROLS, append, compileAgent, endpoint, harness, inspectAgentManifest, loop, mainLoop, markdown, markdownFile, model, modelFleet, overwrite, policy, prepend, replaceLastLines, sandbox, session, statePlane, storage, tool, toolPolicies, tools, validateAgentManifest, } from "../runtimeImplementation/runtimeAgentManifest.js";
+export { buildMcpServerProfilesFromManifest, createMcpApplicationStateView, mcp, planMcpHarnessExposure, };
+export { createMemoryPlane, memoryPlane, };
+export { capabilities, capability, createProvisionPlan, dependencies, dependencyAuthoring, provisionRuntimeDescriptor, } from "../runtimeImplementation/runtime.provisionPlane/index.js";
+export { component, createRuntimeComponentRegistry, lookupRuntimeComponent, officialRuntimeComponents, } from "../runtimeImplementation/runtime.componentPlane/index.js";
+export { canonicalDependencyId, createDependencySourceRegistry, defaultManagedRoot, ensureDependencyAvailable, lookupDependencySource, officialDependencySources, planDependencyInstallation, probeDependency, } from "../runtimeImplementation/runtime.dependencyPlane/index.js";
+export { adjudicateRuntimeDecision, analyzeMainLoopCacheHealth, createLoopTick, createMainLoopApprovalEnvelope, createMainLoopBehaviorRegistry, createMainLoopCancelToken, createMainLoopCheckpoint, createMainLoopControlAction, createMainLoopRun, createMainLoopRollbackPoint, createMainLoopSessionTimeline, createMainLoopStepRecord, createMainLoopTimelineRef, createUserTurn, decideMainLoopFinalAcceptance, exposeMainLoopState, planFrameworkMainLoopHandoff, prepareMainLoopTurn, replayMainLoopStep, replayMainLoopTick, replayUserTurn, resolveMainLoopApproval, resolveMainLoopBehaviorRef, resolveMainLoopFailureRecovery, resolveMainLoopBudget, resolveMainLoopBudgetExhaustion, resolveMainLoopContinuation, resolveMainLoopToolChoice, runMainLoop, selectMainLoopModel, DEFAULT_MAIN_LOOP_BUDGET, DEFAULT_MAIN_LOOP_FAILURE_RECOVERY_POLICY, MAIN_LOOP_CONTROL_PRIMITIVES, } from "../executionEngine/coreLogic/mainLoop.js";
+export { interpretModelDecision, } from "../executionEngine/coreLogic/modelDecision.js";
+export { DEFAULT_OBSERVATION_COMPRESSION_POLICY, DEFAULT_OBSERVATION_SUMMARY_DELEGATION_POLICY, DEFAULT_SUMMARY_AGENT_REF, DEFAULT_TOOL_RESULT_SIZE_POLICY, createObservationMaterial, } from "../executionEngine/coreLogic/observationIntegrator.js";
+export { createEphemeralProcedureExecutionState, normalizeEphemeralProcedurePlan, } from "../executionEngine/coreLogic/ephemeralProcedure.js";
+export { runMainLoopEngine, } from "../executionEngine/coreLogic/mainLoopEngine.js";
+export { createMainLoopCoreEvent, createMainLoopRecorder, } from "../executionEngine/coreLogic/mainLoopRecorder.js";
+export { noopMainLoopSummarizer, createMainLoopStreamAccumulator, reduceMainLoopStreamAccumulator, } from "../executionEngine/coreLogic/mainLoopPorts.js";
+export { addMainLoopBudgetUsage, addMainLoopObservationRefs, clearMainLoopOneShotToolContextSelection, consumeMainLoopPendingInputs, createMainLoopBudgetUsage, createMainLoopTurnState, enqueueMainLoopPendingInput, interruptMainLoopTurnState, registerMainLoopApprovalWait, resumeMainLoopTurnState, setMainLoopToolContextSelection, transitionMainLoopTurnState, } from "../executionEngine/coreLogic/turnState.js";
+export { runToolExecutionUnits, toolExecutionUnitFromProcedureStep, toolExecutionUnitFromToolCall, toolExecutionUnitsFromEphemeralProcedure, } from "../executionEngine/coreLogic/toolScheduler.js";
+export { assemblePromptPack, } from "../executionEngine/promptPack/promptAssembler.js";
+export { createContextCompactionPipelineExecutor, createLocalSummaryCompactExecutor, createRuntimeFallbackCompactExecutor, decideTurnBoundaryCompact, CONTEXT_COMPACTOR_RESPONSE_SCHEMA, CONTEXT_ORGANIZER_RESPONSE_SCHEMA, LOCAL_SUMMARY_COMPACT_RESPONSE_SCHEMA, } from "../executionEngine/coreLogic/contextCompact.js";
+export { PRE_COMPACT_GOVERNANCE_SCHEMA, createModelPreCompactGovernanceExecutor, createNoopPreCompactGovernanceExecutor, createSkippedPreCompactGovernanceRecord, packetMaterialRefs, parsePreCompactGovernanceResult, preCompactGovernanceInstruction, } from "../executionEngine/coreLogic/preCompactGovernance.js";
+export { PRAXIS_BASE_TOOL_CALLING_PROTOCOL, assemblePromptContextMaterials, promptPackMaterialsForManifest, } from "../runtimeImplementation/runtime.execEngine/promptContextAssembly.js";
+export { PROMPT_PACK_PROVIDER_VISIBLE_SEGMENT_KINDS, PROMPT_PACK_SEGMENT_KINDS, inferPromptPackSegmentKind, } from "../executionEngine/promptPack/promptDefiner.js";
+export { createSandboxCommandPlan, createLocalSandboxRemoteWorkerAdapter, runSandboxCommand, sandboxCommandRunnerDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/sandboxCommandRunner.js";
+export { createSandboxRuntimeProvider, prepareSandboxRuntime, resolveRaxcellBinaryPath, sandboxRuntimeProviderDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/sandboxRuntimeProvider.js";
+export { createRaxcellSandboxProvider, mapSandboxProviderRequestToRaxcell, raxcellSandboxProviderDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/raxcellSandboxProvider.js";
+export { runSandboxPolicyMiddleware, sandboxPolicyMiddlewareDescriptor, } from "../runtimeImplementation/runtime.sandboxPlane/sandboxPolicyMiddleware.js";
+export { approvalInterfaceEnvelope, createInterfaceEnvelope, eventInterfaceEnvelope, managementInterfaceEnvelope, repairInterfaceEnvelope, stateInterfaceEnvelope, } from "../interfaceAdapter/interfaceEnvelope.js";
+export { bindBasicInterfaceLayer, } from "../runtimeImplementation/runtime.interfaceAdapter/bindBasicInterfaceLayer.js";
+export { createInterfaceAdapterRuntime, } from "../runtimeImplementation/runtime.interfaceAdapter/interfaceAdapterRuntime.js";
+export { applyRaxStorageInitPlan, createAndApplyStoragePlaneRuntime, createRaxStorageLayout, createStoragePlaneRuntime, planRaxStorageInit, resolveRaxHome, resolveRaxWorkspace, } from "../runtimeImplementation/runtime.storagePlane/storagePlaneRuntime.js";
+export { openPraxisProject, projectDescriptor, project, createInMemoryProjectStore, createSqliteProjectStore, } from "../runtimeImplementation/runtime.projectPlane/index.js";
+export { createPraxisSessionManager, } from "../runtimeImplementation/runtime.sessionPlane/index.js";
+export { createPraxisConversationManager, } from "../runtimeImplementation/runtime.conversationPlane/index.js";
+export { PraxisRuntimeKernel, createPraxisRuntimeKernel, } from "../runtimeImplementation/praxisRuntimeKernel.js";
+export { createInMemorySessionStateEventStore, } from "../runtimeImplementation/runtimeSessionStateEventStore.js";
+export { bindProviderRoleModel, bindRaxodeRoleModel, createProviderModelEntry, createProviderProfileConfiguration, createProviderSecret, createRaxodeModelEntry, createRaxodeProviderProfile, createRaxodeSecret, maskProviderSecret, maskRaxodeSecret, resolveProviderRequestUrl, resolveRaxodeProviderRequestUrl, } from "../modelAdapter/authProfileLayer/providerConfiguration.js";
+export { createFrameworkInspectionReport, } from "../runtimeImplementation/runtime.inspection/frameworkInspectionReport.js";
+export { baseToolDeveloperCatalogDescriptor, baseToolCodingCoreDescriptor, basetool, baseToolProfile, createBaseToolRegistry, createBaseToolSupportCatalog, evaluateBaseToolRuntimeReadiness, listBaseToolDeveloperCatalog, listBaseToolProfiles, toolSets, tryBaseToolById, } from "../basetool/index.js";
+export { baseToolRealityLedgerDescriptor, createBaseToolRealityLedger, inspectBaseToolReality, snapshotBaseToolRealityLedger, } from "../runtimeImplementation/runtime.execEngine/baseToolRealityLedger.js";
+export { runtimeAuth, runtimeAuth as auth, authAuditEvent, bindRuntimeAuthRole, createInMemoryRuntimeAuthSecretVault, createRuntimeAuthModelEntry, createRuntimeAuthProviderProfile, createRuntimeAuthRegistry, createRuntimeAuthResolver, createRuntimeAuthSecretRecord, decryptRuntimeAuthSecretRecord, runtimeAuthCredentialRef, toRuntimeAuthSecretPublicView, } from "../runtimeImplementation/runtime.authPlane/index.js";
+export { ExecutionMonitor, analyzeExecutionMonitor, } from "../runtimeImplementation/runtime.executionMonitor/index.js";
+export { createProviderToolMappings, createPraxisToolDeclarations, lowerPraxisToolsForProvider, lowerProviderToolResult, normalizeProviderInputSchema, providerToolName, raiseProviderToolCalls, } from "../modelAdapter/bridgingLayer/toolSchemaCompatibilityLayer.js";
 /**
  * Recommended developer authoring boxes.
  *
@@ -54,9 +89,11 @@ export const authoringPrimitives = Object.freeze({
 export const promptPack = Object.freeze({
     PromptPack,
     append,
+    assemblePromptContextMaterials,
     markdown,
     markdownFile,
     overwrite,
+    promptPackMaterialsForManifest,
     prepend,
     replaceLastLines,
 });
@@ -76,7 +113,12 @@ export const harnessRuntimePolicy = Object.freeze({
     storage,
 });
 export const baseTool = Object.freeze({
-    baseTools,
+    basetool,
+    profile: baseToolProfile,
+    profiles: listBaseToolProfiles,
+    createBaseToolRegistry,
+    createBaseToolSupportCatalog,
+    evaluateBaseToolRuntimeReadiness,
     tool,
     tools,
     toolPolicies,
@@ -84,11 +126,21 @@ export const baseTool = Object.freeze({
     tryBaseToolById,
     listBaseToolDeveloperCatalog,
     baseToolDeveloperCatalogDescriptor,
+    baseToolCodingCoreDescriptor,
 });
 export const runtimeKernel = Object.freeze({
     PraxisRuntimeKernel,
     createPraxisRuntimeKernel,
     createInMemorySessionStateEventStore,
+    project: Object.freeze({
+        open: openPraxisProject,
+    }),
+    session: Object.freeze({
+        createPraxisSessionManager,
+    }),
+    conversation: Object.freeze({
+        createPraxisConversationManager,
+    }),
 });
 export const executionCore = Object.freeze({
     adjudicateRuntimeDecision,
@@ -101,6 +153,7 @@ export const executionCore = Object.freeze({
     createMainLoopTimelineRef,
     createUserTurn,
     decideMainLoopFinalAcceptance,
+    decideTurnBoundaryCompact,
     exposeMainLoopState,
     interpretModelDecision,
     planFrameworkMainLoopHandoff,
@@ -109,7 +162,9 @@ export const executionCore = Object.freeze({
     resolveMainLoopBudget,
     runMainLoop,
     selectMainLoopModel,
-    createFallbackMemoryRef,
+    createContextCompactionPipelineExecutor,
+    createLocalSummaryCompactExecutor,
+    createRuntimeFallbackCompactExecutor,
     createObservationMaterial,
 });
 export const inspection = Object.freeze({
@@ -128,9 +183,53 @@ export const storagePlane = Object.freeze({
     resolveRaxHome,
     resolveRaxWorkspace,
 });
+export const memory = Object.freeze({
+    ...memoryPlane,
+});
+export const projectPlane = Object.freeze({
+    project: defineProject,
+    descriptor: projectDescriptor,
+    open: openPraxisProject,
+    createSessionManager: createPraxisSessionManager,
+    createConversationManager: createPraxisConversationManager,
+});
+export const provisionPlane = Object.freeze({
+    capabilities,
+    capability,
+    dependencies,
+    dependency: dependencyAuthoring,
+    createProvisionPlan,
+    provisionRuntimeDescriptor,
+});
+export const componentPlane = Object.freeze({
+    component,
+    createRuntimeComponentRegistry,
+    lookupRuntimeComponent,
+    officialRuntimeComponents,
+});
+export const dependencyPlane = Object.freeze({
+    canonicalDependencyId,
+    createDependencySourceRegistry,
+    defaultManagedRoot,
+    ensureDependencyAvailable,
+    lookupDependencySource,
+    officialDependencySources,
+    planDependencyInstallation,
+    probeDependency,
+});
 export const sandboxPlane = Object.freeze({
+    createRaxcellSandboxProvider,
+    createSandboxCommandPlan,
+    createLocalSandboxRemoteWorkerAdapter,
     createSandboxRuntimeProvider,
+    mapSandboxProviderRequestToRaxcell,
     prepareSandboxRuntime,
+    resolveRaxcellBinaryPath,
+    runSandboxPolicyMiddleware,
+    runSandboxCommand,
+    raxcellSandboxProviderDescriptor,
+    sandboxCommandRunnerDescriptor,
+    sandboxPolicyMiddlewareDescriptor,
     sandboxRuntimeProviderDescriptor,
 });
 export const interfaceAdapter = Object.freeze({
@@ -153,7 +252,7 @@ export const interfaceAdapter = Object.freeze({
  * ```
  *
  * 然后用 `praxis.AgentArchetype`、`praxis.prompt.append`、
- * `praxis.model(...)`、`praxis.baseTools.code.read()` 来定义 Agent。
+ * `praxis.model(...)`、`praxis.basetool.core.fileRead()` 来定义 Agent。
  */
 export const praxis = Object.freeze({
     Agent: PraxisAgent,
@@ -174,22 +273,42 @@ export const praxis = Object.freeze({
     endpoint,
     model,
     modelFleet,
+    auth: runtimeAuth,
     harness,
     loop,
     mainLoop,
     policy,
     sandbox,
+    capabilities,
+    capability,
+    dependencies,
+    dependency: dependencyAuthoring,
+    component,
     session,
+    project: defineProject,
     statePlane,
     storage,
-    baseTools,
+    memory,
+    basetool,
+    basetools: basetool,
+    baseTool,
+    baseToolProfile,
+    listBaseToolProfiles,
+    createBaseToolRegistry,
+    createBaseToolSupportCatalog,
+    evaluateBaseToolRuntimeReadiness,
     tool,
     tools,
     toolPolicies,
     toolSets,
     tryBaseToolById,
     listBaseToolDeveloperCatalog,
+    baseToolCodingCoreDescriptor,
     runtime: runtimeKernel,
+    projectPlane,
+    provision: provisionPlane,
+    dependencyPlane,
+    componentPlane,
     execution: executionCore,
     inspection,
     storagePlane,

package/dist/applicationLayer/applicationContract.d.ts

@@ -1,4 +1,7 @@
+import type { BaseToolProfileName } from "../basetool/types.js";
+import type { McpApplicationStateView } from "../runtimeImplementation/runtime.mcpPlane/index.js";
 export type PraxisApplicationRuntimeMode = "dry-run" | "live";
+export type PraxisApplicationToolProfile = BaseToolProfileName;
 export type PraxisApplicationPermissionProfile = "restricted" | "standard" | "permissive" | "yolo" | "bapr";
 export type PraxisApplicationReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
 export type PraxisApplicationStatus = "idle" | "starting" | "ready" | "running" | "awaiting-approval" | "completed" | "failed" | "closed";
@@ -29,7 +32,32 @@ export type PraxisApplicationModelState = {
     usableInputTokens?: number;
     metadataSource?: string;
 };
+export type PraxisApplicationAuthProfileView = {
+    profileId: string;
+    provider: string;
+    providerLabel: string;
+    endpointShape?: string;
+    baseURL?: string;
+    credentialRefId?: string;
+    secretId?: string;
+    secretPresent: boolean;
+    expiresAt?: string;
+    status: "unknown" | "active" | "expired" | "missing" | "error";
+    publicSafe: true;
+};
+export type PraxisApplicationAuthState = {
+    defaultRole?: string;
+    activeProfileId?: string;
+    profiles: readonly PraxisApplicationAuthProfileView[];
+    lastAuditEventKind?: string;
+    lastAuditAt?: string;
+    publicSafe: true;
+};
 export type PraxisApplicationToolCatalogState = {
+    profile: PraxisApplicationToolProfile;
+    availableProfiles: readonly PraxisApplicationToolProfile[];
+    defaultPolicyProfile: PraxisApplicationPermissionProfile;
+    extensionSlots: readonly string[];
     total: number;
     mounted: number;
     byFamily: Readonly<Record<string, number>>;
@@ -45,6 +73,7 @@ export type PraxisApplicationUsageTelemetry = {
     cachedInputTokens?: number;
     lastInputTokens?: number;
     lastTotalTokens?: number;
+    lastPromptPackTokens?: number;
     source?: string;
     estimated: boolean;
     modelCalls: number;
@@ -52,11 +81,14 @@ export type PraxisApplicationUsageTelemetry = {
 export type PraxisApplicationContextTelemetry = {
     activeTokens: number;
     promptTokens: number;
+    sessionContextTokens: number;
+    compressionLimitTokens?: number;
     transcriptTokens: number;
     summaryTokens: number;
     historyMessages: number;
     lastRequestInputTokens?: number;
     lastRequestTotalTokens?: number;
+    promptPackTokens?: number;
     historyEstimatedTokens?: number;
     contextSource?: "application.history.estimate" | "provider.model-call.usage";
     usageSource?: string;
@@ -105,15 +137,28 @@ export type PraxisApplicationViewModel = {
     sessionId: string;
     agentId: string;
     agentEntries: readonly PraxisApplicationAgentEntryView[];
+    agents: {
+        active: number;
+    };
     status: PraxisApplicationStatus;
     workspaceRoot: string;
     mode: PraxisApplicationRuntimeMode;
     model: PraxisApplicationModelState;
+    auth?: PraxisApplicationAuthState;
     permissionProfile: PraxisApplicationPermissionProfile;
+    toolProfile: PraxisApplicationToolProfile;
+    foundationProject?: {
+        projectId: string;
+        kind: "chat" | "workspace-project";
+        workspaceRoot: string;
+        sessionSqlitePath: string;
+        locked: boolean;
+    };
     sessions: readonly PraxisApplicationSessionSummary[];
     approvals: readonly PraxisApplicationApprovalSummary[];
     manifest?: PraxisApplicationManifestView;
     tools: PraxisApplicationToolCatalogState;
+    mcp: McpApplicationStateView;
     counters: {
         turns: number;
         events: number;
@@ -228,6 +273,10 @@ export type PraxisApplicationCommand = {
     type: "application.changePermissionProfile";
     sessionId?: string;
     profile: PraxisApplicationPermissionProfile;
+} | {
+    type: "application.changeToolProfile";
+    sessionId?: string;
+    profile: PraxisApplicationToolProfile;
 } | {
     type: "application.close";
     sessionId?: string;
@@ -241,6 +290,7 @@ export type PraxisApplicationCommandResult = {
     ok: false;
     view: PraxisApplicationViewModel;
     events: readonly PraxisApplicationEvent[];
+    output?: unknown;
     error: {
         code: string;
         message: string;

package/dist/applicationLayer/applicationRuntime.d.ts

@@ -1,21 +1,55 @@
-import { type AgentManifest, type RuntimeApprovalResolver } from "../agentCore/index.js";
-import type { OpenAIV1ResponsesProviderCaller } from "../agentCore/agent_modelAdapter/actualInvocationLayer/openai/v1_responses.js";
-import type { OpenAiV1ChatCompletionsProviderCaller } from "../agentCore/agent_modelAdapter/actualInvocationLayer/openai/v1_chat_completions.js";
-import type { AnthropicV1MessagesProviderCaller } from "../agentCore/agent_modelAdapter/actualInvocationLayer/anthropic/v1_messages.js";
-import type { AuthEnvelope } from "../agentCore/agent_modelAdapter/authProfileLayer/authEnvelope.js";
-import type { PraxisApplicationPermissionProfile, PraxisApplicationReasoningEffort, PraxisApplicationRuntime, PraxisApplicationRuntimeMode } from "./applicationContract.js";
+import { type AgentManifest, type BaseToolExecutorPort, type AgentToolCallProgressEvent, type RuntimeApprovalResolver, type RuntimeAgentReviewResolver, type RuntimeAuthResolver, type RuntimeAuthResolverRequest, type SandboxExecutionProviderPort, type CompactExecutor, type PreCompactGovernanceExecutor, type PraxisProjectRuntime } from "../agentCore/index.js";
+import { type McpApplicationServerInput, type McpHarnessModuleSpec, type McpPlusApplicationServerInput } from "../runtimeImplementation/runtime.mcpPlane/index.js";
+import { type OpenAIV1ResponsesProviderCaller, type OpenAIV1ResponsesResult } from "../modelAdapter/actualInvocationLayer/openai/v1_responses.js";
+import type { OpenAiV1ChatCompletionsProviderCaller } from "../modelAdapter/actualInvocationLayer/openai/v1_chat_completions.js";
+import type { AnthropicV1MessagesProviderCaller } from "../modelAdapter/actualInvocationLayer/anthropic/v1_messages.js";
+import type { DeepMindV1BetaModelsGenerateContentTransport } from "../modelAdapter/actualInvocationLayer/deepmind/v1beta_models_generateContent.js";
+import type { AuthEnvelope } from "../modelAdapter/authProfileLayer/authEnvelope.js";
+import type { PraxisApplicationEvent, PraxisApplicationModelState, PraxisApplicationAuthState, PraxisApplicationPermissionProfile, PraxisApplicationReasoningEffort, PraxisApplicationRuntime, PraxisApplicationRuntimeMode, PraxisApplicationStatus, PraxisApplicationToolProfile } from "./applicationContract.js";
 import { type PraxisApplicationProject } from "./applicationProject.js";
 export type PraxisApplicationLiveProvider = {
-    auth: AuthEnvelope;
+    auth?: AuthEnvelope;
+    runtimeAuthResolver?: RuntimeAuthResolver;
+    authSelection?: RuntimeAuthResolverRequest;
     providerCaller?: OpenAIV1ResponsesProviderCaller;
     openaiResponsesCaller?: OpenAIV1ResponsesProviderCaller;
     openaiChatCompletionsCaller?: OpenAiV1ChatCompletionsProviderCaller;
     anthropicMessagesCaller?: AnthropicV1MessagesProviderCaller;
+    geminiGenerateContentTransport?: DeepMindV1BetaModelsGenerateContentTransport;
     provider?: string;
     endpointShape?: string;
     baseURL?: string;
     providerRoute?: string;
 };
+export type PraxisApplicationBaseToolIntegrationOptions = {
+    toolProfile?: PraxisApplicationToolProfile;
+    policyMode?: PraxisApplicationPermissionProfile;
+    approvalResolver?: RuntimeApprovalResolver;
+    agentReviewResolver?: RuntimeAgentReviewResolver;
+    contextArtifactAdapters?: Pick<Partial<BaseToolExecutorPort>, "context" | "artifact">;
+    baseToolAdapters?: Partial<BaseToolExecutorPort>;
+    onToolEvent?: (event: PraxisApplicationEvent) => void | Promise<void>;
+};
+export type PraxisApplicationInitialConversationMessage = {
+    role: "user" | "assistant" | "model" | "tool" | "runtime-summary" | (string & {});
+    text: string;
+    turnId: string;
+    createdAt: string;
+    messageId?: string;
+    causedBy?: string;
+    artifactRefs?: readonly string[];
+    metadata?: Readonly<Record<string, unknown>>;
+    status?: "completed" | "failed";
+};
+export type PraxisApplicationInitialConversation = {
+    sessionId: string;
+    messages: readonly PraxisApplicationInitialConversationMessage[];
+    summary?: {
+        text: string;
+        compactedMessages: number;
+        updatedAt: string;
+    };
+};
 export type PraxisApplicationRuntimeOptions = {
     project: PraxisApplicationProject;
     applicationId?: string;
@@ -31,7 +65,25 @@ export type PraxisApplicationRuntimeOptions = {
     reasoningEffort?: PraxisApplicationReasoningEffort;
     maxOutputTokens?: number;
     permissionProfile?: PraxisApplicationPermissionProfile;
+    toolProfile?: PraxisApplicationToolProfile;
+    agentOptions?: unknown;
+    sandboxProvider?: SandboxExecutionProviderPort;
     approvalResolver?: RuntimeApprovalResolver;
+    agentReviewResolver?: RuntimeAgentReviewResolver;
+    contextArtifactAdapters?: Pick<Partial<BaseToolExecutorPort>, "context" | "artifact">;
+    baseToolAdapters?: Partial<BaseToolExecutorPort>;
+    mcpServers?: readonly McpApplicationServerInput[];
+    mcpPlusServers?: readonly McpPlusApplicationServerInput[];
+    mcpModule?: McpHarnessModuleSpec;
+    onApplicationToolEvent?: (event: PraxisApplicationEvent) => void | Promise<void>;
+    initialConversations?: readonly PraxisApplicationInitialConversation[];
+    foundationProject?: PraxisProjectRuntime;
+    openFoundationProject?: boolean;
+    compactExecutor?: CompactExecutor;
+    preCompactGovernanceExecutor?: PreCompactGovernanceExecutor;
+    preCompactGovernanceEnabled?: boolean;
+    compactContextWindowTokens?: number;
+    compactThresholdRatio?: number;
     liveProviderResolver?: (manifest: AgentManifest, context?: {
         sessionId: string;
         runtimeId: string;
@@ -39,9 +91,37 @@ export type PraxisApplicationRuntimeOptions = {
         onTextDelta?: (delta: string, metadata?: Readonly<Record<string, unknown>>) => void;
         onProviderStreamEvent?: (event: Readonly<Record<string, unknown>>) => void;
     }) => Promise<PraxisApplicationLiveProvider | undefined>;
+    authStateProvider?: (context: {
+        sessionId: string;
+        runtimeId: string;
+        manifest?: AgentManifest;
+        model: PraxisApplicationModelState;
+    }) => PraxisApplicationAuthState | Promise<PraxisApplicationAuthState | undefined> | undefined;
     now?: () => string;
 };
 export type CreateApplicationProjectRuntimeOptions = Omit<PraxisApplicationRuntimeOptions, "project">;
+export type OpenAIResponsesApplicationAdapterRoute = {
+    kind: "openai_responses" | "chatgpt_codex_responses";
+    providerCaller: OpenAIV1ResponsesProviderCaller;
+    baseURL?: string;
+};
+declare function createToolProgressEvent(input: {
+    progress: AgentToolCallProgressEvent;
+    turnId: string;
+    status: PraxisApplicationStatus;
+}): Omit<PraxisApplicationEvent, "publicSafe" | "createdAt">;
+export declare const applicationRuntimeTestHooks: {
+    readonly createToolProgressEvent: typeof createToolProgressEvent;
+};
+export declare function invokeOpenAIResponsesApplicationAdapter(input: {
+    route: OpenAIResponsesApplicationAdapterRoute;
+    auth: AuthEnvelope;
+    runtimeId: string;
+    invocationId: string;
+    callerId: string;
+    requiredScopes: readonly string[];
+    body: unknown;
+}): Promise<OpenAIV1ResponsesResult>;
 export declare function createPraxisApplicationRuntime(options: PraxisApplicationRuntimeOptions): PraxisApplicationRuntime;
 export declare function createApplicationProjectRuntime(projectRoot: string, options?: CreateApplicationProjectRuntimeOptions): Promise<{
     ok: true;
@@ -53,3 +133,4 @@ export declare function createApplicationProjectRuntime(projectRoot: string, opt
         message: string;
     };
 }>;
+export {};