@praxis-ai/praxis 0.1.1 → 0.1.3

package/raxode-tui/dist/raxode-cli/backend/application/raxcellSandboxProvider.js

@@ -0,0 +1,58 @@
+/*
+ * 文件定位：raxode-cli/backend application Raxcell provider bridge。
+ * 核心目的：把 TUI/backend 的 linuxBubblewrap 配置解析成 Praxis 沙箱执行端口。
+ * 边界：这里只装配执行 provider；策略、审批和 fallback 仍由 Praxis runtime/policy middleware 决定。
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { praxis } from "@praxis-ai/praxis";
+const requireFromHere = createRequire(import.meta.url);
+function executableNames(name, platform) {
+    if (platform !== "win32")
+        return [name];
+    const extensions = (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM")
+        .split(";")
+        .filter(Boolean);
+    return [name, ...extensions.map((extension) => `${name}${extension.toLowerCase()}`), ...extensions.map((extension) => `${name}${extension.toUpperCase()}`)];
+}
+export function resolveRaxodeRaxcellBinaryPath(options = {}) {
+    const explicitBinary = (options.env?.RAXCELL_BIN ?? process.env.RAXCELL_BIN)?.trim();
+    const fileExists = options.fileExists ?? existsSync;
+    if (explicitBinary !== undefined && explicitBinary.length > 0) {
+        return fileExists(explicitBinary) ? explicitBinary : undefined;
+    }
+    const platform = options.platform ?? process.platform;
+    const entries = (options.pathEnv ?? process.env.PATH ?? "").split(path.delimiter).filter(Boolean);
+    for (const entry of entries) {
+        for (const name of executableNames("raxcell", platform)) {
+            const candidate = path.join(entry, name);
+            if (fileExists(candidate))
+                return candidate;
+        }
+    }
+    const resolvedPackage = options.resolvePackage?.("@praxis-ai/raxcell/package.json") ?? (() => {
+        try {
+            return requireFromHere.resolve("@praxis-ai/raxcell/package.json");
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    if (resolvedPackage !== undefined) {
+        const packageBinary = path.resolve(path.dirname(resolvedPackage), "dist/cli.js");
+        if (fileExists(packageBinary))
+            return packageBinary;
+    }
+    return undefined;
+}
+export function resolveRaxodeRaxcellSandboxProvider(options) {
+    if (options.sandboxProvider !== undefined)
+        return options.sandboxProvider;
+    if (options.sandboxProfile !== "linuxBubblewrap")
+        return undefined;
+    const binaryPath = resolveRaxodeRaxcellBinaryPath(options);
+    if (binaryPath === undefined)
+        return undefined;
+    return praxis.sandboxPlane.createRaxcellSandboxProvider({ binaryPath });
+}

package/raxode-tui/dist/raxode-cli/backend/application/runtimeReadiness.d.ts

@@ -59,6 +59,7 @@ export type RaxodeBackendReadiness = {
         agentReviewResolver: "configured" | "not-configured";
         contextArtifactAdapters: "configured" | "not-configured";
         baseToolAdapters: "configured" | "not-configured";
+        sandboxProvider: "configured" | "not-configured";
         authStateProvider: "configured" | "not-configured";
         foundationProject: "configured" | "not-configured";
         liveProviderResolver: "configured" | "raxode-default";

package/raxode-tui/dist/raxode-cli/backend/application/runtimeReadiness.js

@@ -60,7 +60,7 @@ function dependencySummary(dependency, probe) {
         ? "block-backend-start"
         : dependency.dependencyId === "dependency.npm.tsx"
             ? "use-built-dist-or-install"
-            : dependency.dependencyId === "dependency.binary.bwrap"
+            : dependency.dependencyId === "dependency.binary.raxcell" || dependency.dependencyId === "dependency.binary.bwrap"
                 ? "degrade-to-workspace-rollback"
                 : dependency.dependencyId === "dependency.secret.provider.core.main"
                     ? "dry-run-or-auth-required-for-live"
@@ -388,6 +388,7 @@ export function inspectRaxodeBackendReadiness(input = {}) {
             agentReviewResolver: input.ports?.agentReviewResolver ?? "not-configured",
             contextArtifactAdapters: input.ports?.contextArtifactAdapters ?? "not-configured",
             baseToolAdapters: input.ports?.baseToolAdapters ?? "not-configured",
+            sandboxProvider: input.ports?.sandboxProvider ?? "not-configured",
             authStateProvider: input.ports?.authStateProvider ?? (view?.auth ? "configured" : "not-configured"),
             foundationProject: input.ports?.foundationProject ?? (view?.foundationProject ? "configured" : "not-configured"),
             liveProviderResolver: input.ports?.liveProviderResolver ?? "raxode-default",
@@ -411,6 +412,7 @@ export function inspectRaxodeBackendReadinessWithLocalProbe(input = {}) {
         now: input.localProbe?.now ?? input.now,
         nodeVersion: input.localProbe?.nodeVersion,
         pathEnv: input.localProbe?.pathEnv,
+        env: input.localProbe?.env,
         platform: input.localProbe?.platform,
         fileExists: input.localProbe?.fileExists,
         resolvePackage: input.localProbe?.resolvePackage,

package/raxode-tui/dist/raxode-cli/backend/application/stdioApplicationServer.d.ts

@@ -1,3 +1,4 @@
+import type { SandboxExecutionProviderPort } from "@praxis-ai/praxis/agent-core";
 import type { RaxodeOptions } from "../agents/codingAgent/config/raxodeOptions.js";
 import type { RaxodeLocalReadinessProbeInput } from "./localReadinessProbe.js";
 type StdioServerOptions = RaxodeOptions & {
@@ -6,6 +7,7 @@ type StdioServerOptions = RaxodeOptions & {
     output?: NodeJS.WritableStream;
     errorOutput?: NodeJS.WritableStream;
     now?: () => string;
+    sandboxProvider?: SandboxExecutionProviderPort;
     localReadinessProbe?: Omit<RaxodeLocalReadinessProbeInput, "manifest">;
 };
 export declare function startRaxodeStdioApplicationServer(options?: StdioServerOptions): Promise<void>;

package/raxode-tui/dist/raxode-cli/backend/application/stdioApplicationServer.js

@@ -8,6 +8,7 @@ import { createApplicationProjectRuntime, createLocalApplicationTransport, } fro
 import { createRaxodeLiveProvider, resolveRaxodeConfiguredModelOptions, } from "../authentication/liveProvider.js";
 import { inspectRaxodeMemoryBridge } from "../memory/memoryBridge.js";
 import { raxodeApplication } from "./raxodeApplication.js";
+import { resolveRaxodeRaxcellSandboxProvider } from "./raxcellSandboxProvider.js";
 import { createRaxodeReadinessEvent, inspectRaxodeBackendReadinessWithLocalProbe, } from "./runtimeReadiness.js";
 function defaultProjectRoot() {
     return new URL("..", import.meta.url).pathname;
@@ -73,6 +74,10 @@ export async function startRaxodeStdioApplicationServer(options = {}) {
         memoryProfile: memoryBridge.profile,
         memoryPromptGuide: memoryBridge.promptGuide,
     };
+    const sandboxProvider = resolveRaxodeRaxcellSandboxProvider({
+        sandboxProfile: options.sandboxProfile,
+        sandboxProvider: options.sandboxProvider,
+    });
     const created = await createApplicationProjectRuntime(projectRoot, {
         applicationId: raxodeApplication.id,
         cwd: startDir,
@@ -87,6 +92,7 @@ export async function startRaxodeStdioApplicationServer(options = {}) {
         permissionProfile,
         toolProfile: "agentCore",
         agentOptions,
+        sandboxProvider,
         now: options.now,
         liveProviderResolver: async (manifest, context) => createRaxodeLiveProvider(manifest, {
             startDir,
@@ -129,6 +135,7 @@ export async function startRaxodeStdioApplicationServer(options = {}) {
                     now: options.now,
                     localProbe: options.localReadinessProbe,
                     ports: {
+                        sandboxProvider: sandboxProvider ? "configured" : "not-configured",
                         liveProviderResolver: "configured",
                     },
                 }),

package/raxode-tui/dist/raxode-cli/backend/directApplicationBackend.d.ts

@@ -1,3 +1,4 @@
+import type { SandboxExecutionProviderPort } from "@praxis-ai/praxis/agent-core";
 import type { CreateApplicationProjectRuntimeOptions, PraxisApplicationRuntimeMode } from "@praxis-ai/praxis/application-layer";
 import type { RaxodeOptions } from "./agents/codingAgent/config/raxodeOptions.js";
 import type { RaxodeLocalReadinessProbeInput } from "./application/localReadinessProbe.js";
@@ -18,6 +19,7 @@ type DirectApplicationBackendOptions = RaxodeOptions & {
     preCompactGovernanceEnabled?: CreateApplicationProjectRuntimeOptions["preCompactGovernanceEnabled"];
     compactContextWindowTokens?: CreateApplicationProjectRuntimeOptions["compactContextWindowTokens"];
     compactThresholdRatio?: CreateApplicationProjectRuntimeOptions["compactThresholdRatio"];
+    sandboxProvider?: SandboxExecutionProviderPort;
     localReadinessProbe?: Omit<RaxodeLocalReadinessProbeInput, "manifest">;
 };
 export declare function startDirectApplicationBackend(options?: DirectApplicationBackendOptions): Promise<void>;

package/raxode-tui/dist/raxode-cli/backend/directApplicationBackend.js

@@ -6,6 +6,7 @@ import { mkdir, appendFile } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { inspectRaxodeMemoryBridge } from "./memory/memoryBridge.js";
+import { resolveRaxodeRaxcellSandboxProvider } from "./application/raxcellSandboxProvider.js";
 import { loadDirectTuiSessionSnapshot, listDirectTuiAgents, saveDirectTuiAgent, saveDirectTuiSessionSnapshot, } from "../frontend/tui/input/direct-session-store.js";
 function defaultProjectRoot() {
     return new URL(".", import.meta.url).pathname;
@@ -29,6 +30,16 @@ function normalizePermissionProfile(value) {
             return "standard";
     }
 }
+function normalizeSandboxProfile(value) {
+    switch (value) {
+        case "hostObserved":
+        case "workspaceOnly":
+        case "linuxBubblewrap":
+            return value;
+        default:
+            return undefined;
+    }
+}
 function normalizeInitialTurnIndex(value) {
     const parsed = typeof value === "number"
         ? value
@@ -747,6 +758,9 @@ export async function startDirectApplicationBackend(options = {}) {
     const permissionProfile = normalizePermissionProfile(options.policyProfile
         ?? process.env.RAXODE_APPLICATION_PERMISSION_PROFILE
         ?? process.env.PRAXIS_PERMISSION_PROFILE);
+    const sandboxProfile = options.sandboxProfile
+        ?? normalizeSandboxProfile(process.env.RAXODE_APPLICATION_SANDBOX_PROFILE
+            ?? process.env.PRAXIS_SANDBOX_PROFILE);
     const reportsDir = path.resolve(options.stateRoot ?? stateRoot, "live-reports");
     await mkdir(reportsDir, { recursive: true });
     const logPath = path.join(reportsDir, `direct-application-${sessionId.replace(/[^\w.-]+/gu, "_")}-${Date.now()}.jsonl`);
@@ -892,7 +906,7 @@ export async function startDirectApplicationBackend(options = {}) {
     });
     const agentOptions = {
         policyProfile: permissionProfile,
-        sandboxProfile: options.sandboxProfile,
+        sandboxProfile,
         persistence: options.persistence,
         includeAllCatalogTools: options.includeAllCatalogTools,
         provider,
@@ -905,6 +919,10 @@ export async function startDirectApplicationBackend(options = {}) {
         memoryProfile: memoryBridge.profile,
         memoryPromptGuide: memoryBridge.promptGuide,
     };
+    const sandboxProvider = resolveRaxodeRaxcellSandboxProvider({
+        sandboxProfile,
+        sandboxProvider: options.sandboxProvider,
+    });
     const created = await applicationLayer.createApplicationProjectRuntime(projectRoot, {
         applicationId: applicationModule.raxodeApplication.id,
         cwd,
@@ -918,6 +936,7 @@ export async function startDirectApplicationBackend(options = {}) {
         maxOutputTokens,
         permissionProfile,
         agentOptions,
+        sandboxProvider,
         initialConversations: restoredInitialConversation === undefined ? [] : [restoredInitialConversation],
         now: options.now,
         compactExecutor: options.compactExecutor,
@@ -1043,6 +1062,7 @@ export async function startDirectApplicationBackend(options = {}) {
         localProbe: options.localReadinessProbe,
         ports: {
             approvalResolver: "configured",
+            sandboxProvider: sandboxProvider ? "configured" : "not-configured",
             liveProviderResolver: options.liveProviderResolver ? "configured" : "raxode-default",
         },
     });

package/raxode-tui/dist/raxode-cli/backend/raxodeBackend.d.ts

@@ -13,7 +13,7 @@ export type RaxodeBackendCommand = {
     toolProfile?: PraxisApplicationToolProfile;
 };
 export type RaxodeBackendResult = PraxisApplicationCommandResult;
-type RaxodeBackendRuntimePorts = Pick<CreateApplicationProjectRuntimeOptions, "approvalResolver" | "agentReviewResolver" | "contextArtifactAdapters" | "baseToolAdapters" | "authStateProvider" | "foundationProject" | "openFoundationProject" | "liveProviderResolver" | "compactExecutor" | "preCompactGovernanceExecutor" | "preCompactGovernanceEnabled" | "compactContextWindowTokens" | "compactThresholdRatio">;
+type RaxodeBackendRuntimePorts = Pick<CreateApplicationProjectRuntimeOptions, "approvalResolver" | "agentReviewResolver" | "contextArtifactAdapters" | "baseToolAdapters" | "authStateProvider" | "sandboxProvider" | "foundationProject" | "openFoundationProject" | "liveProviderResolver" | "compactExecutor" | "preCompactGovernanceExecutor" | "preCompactGovernanceEnabled" | "compactContextWindowTokens" | "compactThresholdRatio">;
 export type RaxodeBackendOptions = RaxodeOptions & RaxodeBackendRuntimePorts & {
     projectRoot?: string;
     cwd?: string;

package/raxode-tui/dist/raxode-cli/backend/raxodeBackend.js

@@ -6,6 +6,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { createApplicationProjectRuntime, createApplicationRestServer, createApplicationWebSocketServer, createLocalApplicationTransport, } from "@praxis-ai/praxis/application-layer";
 import { createRaxodeLiveProvider, resolveRaxodeConfiguredModelOptions, } from "./authentication/liveProvider.js";
+import { resolveRaxodeRaxcellSandboxProvider } from "./application/raxcellSandboxProvider.js";
 import { createRaxodeAuthStateProvider } from "./authentication/authStateProvider.js";
 import { createRaxodeContextAdapter } from "./context/contextBridge.js";
 import { inspectRaxodeMemoryBridge } from "./memory/memoryBridge.js";
@@ -16,6 +17,7 @@ function configuredRuntimePorts(options) {
         agentReviewResolver: options.agentReviewResolver ? "configured" : "not-configured",
         contextArtifactAdapters: options.contextArtifactAdapters ? "configured" : "not-configured",
         baseToolAdapters: options.baseToolAdapters ? "configured" : "not-configured",
+        sandboxProvider: options.sandboxProvider ? "configured" : "not-configured",
         authStateProvider: options.authStateProvider ? "configured" : "not-configured",
         foundationProject: options.foundationProject || options.openFoundationProject ? "configured" : "not-configured",
         liveProviderResolver: options.liveProviderResolver ? "configured" : "raxode-default",
@@ -68,6 +70,10 @@ async function createRaxodeRuntime(options = {}) {
         now: options.now,
     });
     const openFoundationProject = options.openFoundationProject ?? true;
+    const sandboxProvider = resolveRaxodeRaxcellSandboxProvider({
+        sandboxProfile: options.sandboxProfile,
+        sandboxProvider: options.sandboxProvider,
+    });
     const runtimeResult = await createApplicationProjectRuntime(projectRoot, {
         applicationId: "application.raxode.coding",
         runtimeId: options.runtimeId,
@@ -89,6 +95,7 @@ async function createRaxodeRuntime(options = {}) {
         agentReviewResolver: options.agentReviewResolver,
         contextArtifactAdapters,
         baseToolAdapters: options.baseToolAdapters,
+        sandboxProvider,
         authStateProvider,
         foundationProject: options.foundationProject,
         openFoundationProject,
@@ -116,6 +123,7 @@ async function createRaxodeRuntime(options = {}) {
         readinessPorts: configuredRuntimePorts({
             ...options,
             contextArtifactAdapters,
+            sandboxProvider,
             authStateProvider,
             openFoundationProject,
         }),

package/raxode-tui/dist/raxode-cli/frontend/tui/cli/raxode-cli.js

@@ -73,7 +73,7 @@ export function buildBackendReadinessStatusLines(input = {}) {
         const sandboxActionLine = readiness.sandbox.probe?.status === "degraded"
             ? [
                 `profile=${readiness.sandbox.profile}`,
-                readiness.sandbox.probe.executable === undefined ? "install=bwrap" : `executable=${readiness.sandbox.probe.executable}`,
+                readiness.sandbox.probe.executable === undefined ? "install=raxcell" : `executable=${readiness.sandbox.probe.executable}`,
                 `fallback=${readiness.sandbox.probe.fallback}`,
             ].join(", ")
             : "none";
@@ -118,6 +118,20 @@ export function resolveRaxodeCliCommand(argv) {
         rest,
     };
 }
+function optionValue(arg, prefix) {
+    return arg.startsWith(prefix) ? arg.slice(prefix.length).trim() || undefined : undefined;
+}
+function resolveForwardedSandboxProfile(args) {
+    for (const arg of args) {
+        const sandbox = optionValue(arg, "--sandbox=");
+        if (sandbox === "hostObserved"
+            || sandbox === "workspaceOnly"
+            || sandbox === "linuxBubblewrap") {
+            return sandbox;
+        }
+    }
+    return undefined;
+}
 function printUsage() {
     process.stdout.write([
         `${CLI_DISPLAY_NAME} CLI`,
@@ -185,6 +199,10 @@ export function resolveRaxodeLaunchPlan(command, forwardedArgs, options = {}) {
         PRAXIS_APP_ROOT: resolveCliAppRoot(moduleDir),
         PRAXIS_WORKSPACE_ROOT: cwd,
     };
+    const sandboxProfile = resolveForwardedSandboxProfile(forwardedArgs);
+    if (sandboxProfile !== undefined) {
+        env.RAXODE_APPLICATION_SANDBOX_PROFILE = sandboxProfile;
+    }
     const entrypoint = resolveUiEntrypoint(command, moduleDir);
     return {
         command: entrypoint.command,

package/raxode-tui/package.json

@@ -55,7 +55,8 @@
     "@lancedb/lancedb": "^0.27.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@openai/agents": "^0.11.4",
-    "@praxis-ai/praxis": "0.1.0",
+    "@praxis-ai/praxis": "0.1.2",
+    "@praxis-ai/raxcell": "^0.1.5",
     "apache-arrow": "^18.1.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

package/tsconfig.json

@@ -9,7 +9,22 @@
     "noEmit": true,
     "forceConsistentCasingInFileNames": true,
     "skipLibCheck": true,
-    "resolveJsonModule": true
+    "resolveJsonModule": true,
+    "baseUrl": ".",
+    "paths": {
+      "@praxis-ai/praxis": ["src/agentCore/index.ts"],
+      "@praxis-ai/praxis/agentCore": ["src/agentCore/index.ts"],
+      "@praxis-ai/praxis/agent-core": ["src/agentCore/index.ts"],
+      "@praxis-ai/praxis/application": ["src/applicationLayer/index.ts"],
+      "@praxis-ai/praxis/application-layer": ["src/applicationLayer/index.ts"],
+      "@praxis-ai/praxis/basetool": ["src/basetool/index.ts"],
+      "@praxis-ai/praxis/memory": ["src/memory_managementPool/index.ts"],
+      "@praxis-ai/praxis/modelAdapter": ["src/modelAdapter/index.ts"],
+      "@praxis-ai/praxis/model-adapter": ["src/modelAdapter/index.ts"],
+      "@praxis-ai/praxis/modelAdapter/*": ["src/modelAdapter/*.ts"],
+      "@praxis-ai/praxis/model-adapter/*": ["src/modelAdapter/*.ts"],
+      "@praxis-ai/praxis/provider/*": ["src/modelAdapter/*.ts"]
+    }
   },
   "include": ["src/**/*.ts", "test/**/*.ts", "examples/**/*.ts"],
   "exclude": [