workspaceaccess

package
v0.3.0-beta.35 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 18, 2026 License: MIT Imports: 6 Imported by: 0

Documentation

Index

Constants

View Source
const DenialHint = "cross-workspace access is denied by this session's permission mode; " +
	"ask the operator to set the agent's permissions.mode to approve-all, or approve the prompt when asked"

DenialHint is the canonical operator guidance returned by workspace-access seams.

Variables

View Source
var ErrInvalidRequest = errors.New("workspace access: invalid request")

ErrInvalidRequest identifies a structurally invalid workspace-access request.

Functions

This section is empty.

Types

type AccessRecord

type AccessRecord struct {
	Actor    ActorRef
	TargetID string
	Allowed  bool
	Source   DecisionSource
	Mode     Mode
	Seam     Seam
	Err      string
}

AccessRecord is the audit representation of one authorization decision.

type ActorKind

type ActorKind string

ActorKind identifies the trusted runtime origin of an access request.

const (
	ActorAgentSession ActorKind = "agent_session"
	ActorHuman        ActorKind = "human"
	ActorExtension    ActorKind = "extension"
	ActorAutomation   ActorKind = "automation"
	ActorDaemon       ActorKind = "daemon"
)

type ActorRef

type ActorRef struct {
	Kind        ActorKind
	SessionID   string
	WorkspaceID string
	AgentName   string
	Operator    bool
}

ActorRef carries daemon-validated actor identity into the policy.

type AuditEmitter

type AuditEmitter interface {
	EmitWorkspaceAccess(ctx context.Context, record AccessRecord) error
}

AuditEmitter appends one best-effort record per decision.

type Consent string

Consent is a session-lifetime answer captured from an ACP prompt.

const (
	ConsentAllow  Consent = "allow"
	ConsentReject Consent = "reject"
)

type Decision

type Decision struct {
	Allowed        bool
	Source         DecisionSource
	PromptEligible bool
}

Decision is the fail-closed result of one authorization request.

type DecisionSource

type DecisionSource string

DecisionSource records the policy branch that produced a decision.

const (
	SourceOperator       DecisionSource = "operator"
	SourceSameWorkspace  DecisionSource = "same_workspace"
	SourcePermissionMode DecisionSource = "permission_mode"
	SourceSessionConsent DecisionSource = "session_consent"
	SourceDenied         DecisionSource = "denied"
)

type DefaultPolicy

type DefaultPolicy struct {
	// contains filtered or unexported fields
}

DefaultPolicy applies the fixed workspace-access decision chain.

func New

func New(deps Deps) (*DefaultPolicy, error)

New constructs the fail-closed default policy.

func (*DefaultPolicy) Authorize

func (p *DefaultPolicy) Authorize(ctx context.Context, req Request) (Decision, error)

Authorize evaluates and audits one access request.

type Deps

type Deps struct {
	Modes   ModeSource
	Consent SessionConsentCache
	Audit   AuditEmitter
	Log     *slog.Logger
}

Deps contains every dependency required by DefaultPolicy.

type Mode

type Mode string

Mode mirrors the effective permission modes without importing config.

const (
	ModeDenyAll      Mode = "deny-all"
	ModeApproveReads Mode = "approve-reads"
	ModeApproveAll   Mode = "approve-all"
)

type ModeSource

type ModeSource interface {
	SessionPermissionMode(ctx context.Context, sessionID string) (Mode, error)
}

ModeSource resolves the effective permission mode of a live session.

type Policy

type Policy interface {
	Authorize(ctx context.Context, req Request) (Decision, error)
}

Policy is the single decision funnel for cross-workspace access.

type Request

type Request struct {
	Actor             ActorRef
	TargetWorkspaceID string
	Seam              Seam
}

Request is the complete input to one workspace-access decision.

type Seam

type Seam string

Seam identifies the runtime boundary requesting cross-workspace access.

const (
	SeamIdentity Seam = "identity"
	SeamTask     Seam = "task"
	SeamTool     Seam = "tool"
	SeamSpawn    Seam = "spawn"
	SeamCatalog  Seam = "catalog"
)

type SessionConsentCache

type SessionConsentCache interface {
	ConsentFor(ctx context.Context, sessionID string) (Consent, bool)
	PutConsent(ctx context.Context, sessionID string, consent Consent)
}

SessionConsentCache stores one cross-workspace answer per live session.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL