nosis-agent 0.1.1__py3-none-any.whl

agent_core/__init__.py

@@ -0,0 +1,411 @@
+from .agent import (
+    Agent,
+    AgentEvent,
+    AgentRunResult,
+    AssistantMessageDeltaEvent,
+    ReasoningDeltaEvent,
+    AssistantMessageEvent,
+    ModelCompletedEvent,
+    CompressionCompletedEvent,
+    UnitCompletedEvent,
+    ContextWindowEvent,
+    ToolBatchStartedEvent,
+    ToolCallEvent,
+    ToolMediaEvent,
+    ToolResultEvent,
+    UserSteerAppliedEvent,
+    JobStatusEvent,
+)
+from .loop_policy import ToolCallLimitExceededError
+from .hooks import HookCompletedEvent
+from .config import (
+    AgentConfig,
+    ContextCompressionConfig,
+    MemoryConfig,
+    ProviderRequestConfig,
+    SkillConfig,
+    SubagentRoleConfig,
+    load_agent_config,
+)
+from .context_manager import ContextManager, ContextWindow, ContextWindowExceededError
+from .execution import (
+    APPROVAL_REQUIRED_AUTHORITY,
+    CommandCancelled,
+    CommandExecutionResult,
+    CommandOutputSpool,
+    CommandExecutor,
+    ExecutionAuthority,
+    ExecutionRouter,
+    ExecutionScope,
+    FULL_ACCESS_AUTHORITY,
+    FilesystemAccess,
+    HostCommandExecutor,
+    LinuxSandboxBackend,
+    MacOSSandboxBackend,
+    NetworkAccess,
+    ProcessIsolation,
+    SandboxBackend,
+    SandboxedCommandExecutor,
+    SandboxPolicy,
+    ShellLauncher,
+    TemporaryDirectoryMode,
+    ResolvedExecution,
+    WORKSPACE_ACCESS_AUTHORITY,
+    WORKSPACE_ONLY_AUTHORITY,
+    WindowsSandboxBackend,
+    platform_shell_launcher,
+    platform_workspace_sandbox_backend,
+)
+from .errors import (
+    ProviderError,
+    ProviderProtocolError,
+    ProviderRequestError,
+    ProviderStreamError,
+    RuntimeErrorInfo,
+    runtime_error_info,
+)
+from .jobs import (
+    CancellationToken, JobCancelled, JobContext, JobHandle, JobManager,
+    JobResult, JobSnapshot, JobUpdate,
+)
+from .llm import LLMProvider, LLMRequest, LLMResponse, ProviderCapabilities
+from .usage import CacheUsage, TokenUsage
+from .image_generation import GeneratedImage, ImageGenerator
+from .content import (
+    AttachmentPart,
+    Content,
+    ContentPart,
+    FilePart,
+    ImagePart,
+    TextPart,
+)
+from .media import (
+    ImageInfo,
+    MAX_IMAGE_BYTES,
+    SUPPORTED_IMAGE_MIME_TYPES,
+    UnsupportedImageError,
+    estimate_image_tokens,
+    image_extension,
+    probe_image,
+)
+from .memory import (
+    MemoryCandidate,
+    MemoryContext,
+    MemoryDocument,
+    MemoryManager,
+    MemoryReconciler,
+    MemoryStore,
+)
+from .session import (
+    Message,
+    MessageOrigin,
+    Session,
+    message_to_dict,
+)
+from .permissions import PermissionController, PermissionPreset
+from .plan import (
+    MAX_PLAN_STEP_OUTCOME_CHARS,
+    PlanManager,
+    PlanSnapshot,
+    PlanStep,
+    PlanStepStatus,
+    plan_snapshot_to_dict,
+)
+from .session_store import JsonlSessionStore, SessionInUseError
+from .scheduler import (
+    AgentTurnAction,
+    CronTrigger,
+    IntervalTrigger,
+    OneShotTrigger,
+    Schedule,
+    ScheduleUpdateInput,
+    ScheduledRun,
+    SchedulerService,
+    parse_end_at_input,
+    parse_schedule_enabled_input,
+    parse_schedule_id_input,
+    parse_schedule_prompt_input,
+    parse_schedule_update_input,
+    parse_trigger_input,
+    trigger_to_dict,
+)
+from .skills import (
+    DirectorySkillSource,
+    Skill,
+    SkillLoader,
+    SkillLocation,
+    SkillRegistry,
+    SkillSource,
+)
+from .subagent import (
+    SubagentRole,
+    SubagentRoleRegistry,
+    SubagentRuntime,
+    skill_aware_tool_names,
+    vision_aware_tool_names,
+)
+from .tool_result import (
+    DEFAULT_TOOL_RESULT_PREVIEW_CHARS,
+    ToolResultNormalizer,
+)
+from .tool_batch import ToolBatchExecutor
+from .tools import (
+    AnalyzeImageTool,
+    ApplyPatchTool,
+    AskUserTool,
+    CompositeToolPolicy,
+    ComputerApprovalPolicy,
+    ComputerScreenshotTool,
+    ComputerActionTool,
+    EditFileTool,
+    GenerateImageTool,
+    JSONValue,
+    ListDirectoryTool,
+    MAX_TOOL_RESULT_CHARS,
+    McpApprovalPolicy,
+    ReadFileTool,
+    ReadImageTool,
+    ReadSkillTool,
+    RememberTool,
+    SearchFilesTool,
+    ShellApprovalPolicy,
+    FileWriteApprovalPolicy,
+    ShellTool,
+    SubagentTool,
+    JobControlTool,
+    UpdatePlanTool,
+    Tool,
+    ToolCall,
+    ToolCatalog,
+    ToolConfig,
+    ToolDefinition,
+    ToolError,
+    ToolExecutionContext,
+    ToolOutput,
+    ToolPolicy,
+    ToolResult,
+    ToolSet,
+    WebSearchTool,
+    WebFetchTool,
+    WriteFileTool,
+    builtin_catalog,
+    load_tool_config,
+    resolve_image,
+    resolve_readable_path,
+)
+from .mcp import (
+    McpConfig,
+    McpServerConfig,
+    McpTool,
+    McpToolConfig,
+    load_mcp_config,
+    load_mcp_server_map,
+    merge_mcp_servers,
+    namespace_mcp_servers,
+)
+from .workspace import Workspace
+from .workspace_instructions import WorkspaceInstruction, WorkspaceInstructions
+from .turn_control import (
+    AgentCancelled,
+    TurnControl,
+    UserSteer,
+    UserSteeringMailbox,
+)
+
+__all__ = [
+    "Agent",
+    "ApplyPatchTool",
+    "AgentCancelled",
+    "AgentConfig",
+    "AgentEvent",
+    "AgentRunResult",
+    "AnalyzeImageTool",
+    "AskUserTool",
+    "CacheUsage",
+    "AssistantMessageDeltaEvent",
+    "AssistantMessageEvent",
+    "ModelCompletedEvent",
+    "CompressionCompletedEvent",
+    "UnitCompletedEvent",
+    "CommandExecutionResult",
+    "CommandCancelled",
+    "CommandOutputSpool",
+    "CommandExecutor",
+    "ExecutionAuthority",
+    "ExecutionRouter",
+    "ExecutionScope",
+    "ResolvedExecution",
+    "APPROVAL_REQUIRED_AUTHORITY",
+    "FULL_ACCESS_AUTHORITY",
+    "WORKSPACE_ACCESS_AUTHORITY",
+    "WORKSPACE_ONLY_AUTHORITY",
+    "FilesystemAccess",
+    "CompositeToolPolicy",
+    "ComputerApprovalPolicy",
+    "ComputerScreenshotTool",
+    "ComputerActionTool",
+    "Content",
+    "ContentPart",
+    "AttachmentPart",
+    "ContextWindow",
+    "ContextWindowEvent",
+    "ContextCompressionConfig",
+    "ContextManager",
+    "ContextWindowExceededError",
+    "DEFAULT_TOOL_RESULT_PREVIEW_CHARS",
+    "DirectorySkillSource",
+    "EditFileTool",
+    "GeneratedImage",
+    "GenerateImageTool",
+    "ImageInfo",
+    "ImageGenerator",
+    "ImagePart",
+    "FilePart",
+    "HostCommandExecutor",
+    "platform_shell_launcher",
+    "JobCancelled",
+    "JobContext",
+    "JobHandle",
+    "JobManager",
+    "JobResult",
+    "JobSnapshot",
+    "JobControlTool",
+    "JobStatusEvent",
+    "HookCompletedEvent",
+    "JobUpdate",
+    "CancellationToken",
+    "JSONValue",
+    "JsonlSessionStore",
+    "SessionInUseError",
+    "LLMProvider",
+    "LLMRequest",
+    "LLMResponse",
+    "ListDirectoryTool",
+    "LinuxSandboxBackend",
+    "MAX_IMAGE_BYTES",
+    "MAX_PLAN_STEP_OUTCOME_CHARS",
+    "MAX_TOOL_RESULT_CHARS",
+    "MemoryCandidate",
+    "MemoryConfig",
+    "MemoryContext",
+    "MemoryDocument",
+    "MemoryManager",
+    "MemoryReconciler",
+    "MemoryStore",
+    "MacOSSandboxBackend",
+    "McpApprovalPolicy",
+    "McpConfig",
+    "McpServerConfig",
+    "McpTool",
+    "McpToolConfig",
+    "Message",
+    "MessageOrigin",
+    "NetworkAccess",
+    "PermissionController",
+    "PermissionPreset",
+    "PlanManager",
+    "PlanSnapshot",
+    "PlanStep",
+    "PlanStepStatus",
+    "ProviderCapabilities",
+    "ProviderError",
+    "ProviderRequestConfig",
+    "ProviderProtocolError",
+    "ProviderRequestError",
+    "ProviderStreamError",
+    "ProcessIsolation",
+    "ReadFileTool",
+    "ReadImageTool",
+    "ReadSkillTool",
+    "RememberTool",
+    "ReasoningDeltaEvent",
+    "RuntimeErrorInfo",
+    "SandboxBackend",
+    "SandboxedCommandExecutor",
+    "SandboxPolicy",
+    "ShellLauncher",
+    "SUPPORTED_IMAGE_MIME_TYPES",
+    "SearchFilesTool",
+    "Session",
+    "Skill",
+    "SkillConfig",
+    "SkillLoader",
+    "SkillLocation",
+    "SkillRegistry",
+    "SkillSource",
+    "ShellApprovalPolicy",
+    "FileWriteApprovalPolicy",
+    "ShellTool",
+    "SubagentRole",
+    "SubagentRoleConfig",
+    "SubagentRoleRegistry",
+    "SubagentRuntime",
+    "SubagentTool",
+    "TemporaryDirectoryMode",
+    "TextPart",
+    "TokenUsage",
+    "Tool",
+    "ToolBatchStartedEvent",
+    "ToolBatchExecutor",
+    "ToolCall",
+    "ToolCallEvent",
+    "ToolCallLimitExceededError",
+    "ToolCatalog",
+    "ToolConfig",
+    "ToolDefinition",
+    "ToolError",
+    "ToolExecutionContext",
+    "ToolMediaEvent",
+    "ToolOutput",
+    "ToolPolicy",
+    "ToolResult",
+    "ToolResultEvent",
+    "ToolResultNormalizer",
+    "TurnControl",
+    "ToolSet",
+    "UnsupportedImageError",
+    "UpdatePlanTool",
+    "UserSteer",
+    "UserSteerAppliedEvent",
+    "UserSteeringMailbox",
+    "WebFetchTool",
+    "WebSearchTool",
+    "WindowsSandboxBackend",
+    "platform_workspace_sandbox_backend",
+    "WriteFileTool",
+    "AgentTurnAction",
+    "CronTrigger",
+    "IntervalTrigger",
+    "OneShotTrigger",
+    "Schedule",
+    "ScheduleUpdateInput",
+    "parse_end_at_input",
+    "parse_schedule_enabled_input",
+    "parse_schedule_id_input",
+    "parse_schedule_prompt_input",
+    "parse_schedule_update_input",
+    "parse_trigger_input",
+    "trigger_to_dict",
+    "ScheduledRun",
+    "SchedulerService",
+    "Workspace",
+    "WorkspaceInstruction",
+    "WorkspaceInstructions",
+    "builtin_catalog",
+    "estimate_image_tokens",
+    "image_extension",
+    "load_agent_config",
+    "load_mcp_config",
+    "load_mcp_server_map",
+    "merge_mcp_servers",
+    "namespace_mcp_servers",
+    "load_tool_config",
+    "message_to_dict",
+    "probe_image",
+    "plan_snapshot_to_dict",
+    "resolve_image",
+    "resolve_readable_path",
+    "runtime_error_info",
+    "skill_aware_tool_names",
+    "vision_aware_tool_names",
+]

agent_core/_posix_files.py

@@ -0,0 +1,84 @@
+"""Descriptor-relative filesystem operations for the file tools."""
+
+import errno
+import os
+import shutil
+import stat
+from typing import BinaryIO
+from uuid import uuid4
+
+
+_DIRECTORY = getattr(os, "O_PATH", os.O_RDONLY) | os.O_DIRECTORY | os.O_NOFOLLOW
+
+
+def open_root(anchor: str) -> int:
+    return os.open(anchor, _DIRECTORY)
+
+
+def close(directory: int) -> None:
+    os.close(directory)
+
+
+def open_directory(parent: int, name: str) -> int:
+    return os.open(name, _DIRECTORY, dir_fd=parent)
+
+
+def mkdir(parent: int, name: str) -> None:
+    os.mkdir(name, dir_fd=parent)
+
+
+def mode(parent: int, name: str) -> int:
+    result = os.stat(name, dir_fd=parent, follow_symlinks=False).st_mode
+    if stat.S_ISLNK(result):
+        raise OSError(errno.ELOOP, "file path changed to a symbolic link", name)
+    return result
+
+
+def open_read(parent: int, name: str) -> int:
+    descriptor = os.open(
+        name, os.O_RDONLY | os.O_NOFOLLOW | os.O_NONBLOCK, dir_fd=parent,
+    )
+    try:
+        if not stat.S_ISREG(os.fstat(descriptor).st_mode):
+            raise OSError(errno.EINVAL, "path must be a regular file", name)
+        return descriptor
+    except BaseException:
+        os.close(descriptor)
+        raise
+
+
+def write(
+    parent: int, name: str, data: bytes | BinaryIO, *, replace: bool, permissions: int | None
+) -> None:
+    temporary = f".nosis-{uuid4().hex}.tmp"
+    descriptor = os.open(
+        temporary, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600, dir_fd=parent,
+    )
+    try:
+        with os.fdopen(descriptor, "wb") as file:
+            if isinstance(data, bytes):
+                file.write(data)
+            else:
+                shutil.copyfileobj(data, file)
+            file.flush()
+            if permissions is not None:
+                os.fchmod(file.fileno(), permissions)
+            os.fsync(file.fileno())
+        if replace:
+            os.replace(temporary, name, src_dir_fd=parent, dst_dir_fd=parent)
+            temporary = None
+        else:
+            os.link(
+                temporary, name, src_dir_fd=parent, dst_dir_fd=parent,
+                follow_symlinks=False,
+            )
+    finally:
+        if temporary is not None:
+            try:
+                os.unlink(temporary, dir_fd=parent)
+            except FileNotFoundError:
+                pass
+
+
+def unlink(parent: int, name: str) -> None:
+    os.unlink(name, dir_fd=parent)