Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

2.7 KB
Raw Blame
package skills

import (
	"context"
	"fmt"

	"github.com/Tencent/WeKnora/internal/sandbox"
)

// PrepareShellEnvironment attaches an allowed, installed skill's runtime to
// the same shell primitive used for ordinary commands. Credentials remain the
// caller's responsibility and are resolved per tool call, never persisted here.
func (m *Manager) PrepareShellEnvironment(ctx context.Context, sessionID, skillName, command string, env map[string]string) (string, map[string]string, error) {
	if err := ctx.Err(); err != nil {
		return "", nil, err
	}
	if m == nil || !m.enabled || !m.isSkillAllowed(skillName) {
		return "", nil, fmt.Errorf("skill %q is not available to this agent", skillName)
	}
	dir, ok := m.SandboxSkillDir(skillName)
	if !ok {
		var err error
		dir, err = m.stageShellSkill(ctx, sessionID, skillName)
		if err != nil {
			return "", nil, err
		}
	} else if _, valid := sandbox.ValidatedSkillDirUnder(m.installedSkillsRoot(), dir); !valid {
		return "", nil, fmt.Errorf("invalid installed directory for skill %q", skillName)
	}
	runtimeEnv := make(map[string]string, len(env)+6)
	for k, v := range env {
		runtimeEnv[k] = v
	}
	applySkillNodePath(runtimeEnv, dir)
	runtimeEnv[skillDirEnvVar] = dir
	outputDir, inputDir := ArtifactOutputDir(), sandbox.SessionInputRoot
	if layout, ok := m.sessionLayout(ctx, sessionID); ok {
		switch {
		case layout.IsHost() && layout.HasRoot():
			// Host has no collected output tree or attachment directory yet:
			// point deliverables at the workspace and leave the input
			// variable unset rather than naming a /workspace path.
			outputDir, inputDir = layout.Root, ""
		case layout.IsSharedRemote():
			outputDir, inputDir = layout.OutputDir, layout.InputDir
		}
	}
	runtimeEnv[artifactOutputEnvVar] = outputDir
	runtimeEnv[artifactHistoryEnvVar] = outputDir
	if inputDir != "" {
		runtimeEnv[sessionInputEnvVar] = inputDir
	}
	// Set PATH after the provider's login shell has loaded its profiles. Use a
	// child non-login shell so leading assignments and arbitrary shell grammar
	// keep their original meaning and cannot consume the setup prefix.
	prefix := sandbox.SkillCommandPath(dir)
	wrapped := "export PATH=" + sandbox.ShellQuote(prefix) + ":\"$PATH\"; exec /bin/bash --noprofile --norc -c " + sandbox.ShellQuote(command)
	return wrapped, runtimeEnv, nil
}

func (m *Manager) sessionLayout(ctx context.Context, sessionID string) (sandbox.WorkspaceLayout, bool) {
	provider, ok := m.sandboxMgr.(sandbox.SessionWorkspaceLayoutProvider)
	if !ok || provider == nil {
		return sandbox.WorkspaceLayout{}, false
	}
	layout, err := provider.SessionWorkspaceLayout(ctx, sessionID)
	if err != nil {
		return sandbox.WorkspaceLayout{}, false
	}
	return layout.Normalized(), true
}