Table of Contents

Namespace Oscova.Agents.Tasks

Classes

AgentRunPlan

Customizations an agent task handler applies around the standard agent run.

AgentTaskCatalog

Builds an in-memory catalogue from caller-owned task directories.

AgentTaskCatalogEntry

Describes task metadata needed for catalogue lookup and filtering.

AgentTaskContext

Holds contextual data for the currently executing agent task.

AgentTaskDefinition

Describes a saved unit of agent work that can run manually or on a schedule.

AgentTaskRepository

Persists task definitions and run artifacts beneath a caller-selected users root.

AgentTaskRun

Captures the persisted and live state of one task execution.

AgentTaskRunObserver

Projects the first current-run user message, eligible tool-result messages, non-streaming responses, and the first assembled instruction into one task run.

AgentTaskSchedulerService

Background scheduler that starts enabled agent tasks when their schedules become due.

DuplicateExternalTriggerSlugException

Identifies an external-trigger slug already owned by another task.

NotificationChannels

Defines built-in task notification channel identifiers.

TaskExternalParameter

Describes one allowed external trigger parameter.

TaskExternalTrigger

Configures the externally callable webhook trigger for a task.

TaskExternalTriggerValidationException

Reports a typed external task trigger validation failure without transport wording.

TaskExternalTriggerValidator

Validates supplied parameters against a task's external-trigger schema.

TaskFileValueFormatter

Formats enum-like values as task-file YAML tokens.

TaskInstructionRenderer

Renders external-trigger parameter placeholders in a task instruction.

TaskRunScope

Overrides selected agent runtime settings for one task run without changing agent.md.

TaskRunScopeResolver

Resolves task-local runtime settings into an effective one-run agent surface.

TaskRunScopeValidationCatalog

Carries the live user-specific choices a task run scope may reference.

TaskRunSurface

Resolved one-run view of an agent; it is runtime-only and must not be saved back to agent.md.

TaskSchedule

Defines when and how an agent task should run.

TaskScheduleEvaluator

Evaluates task schedules against the latest run state and current time.

TaskStatusUpdate

Notification payload for task status changes.

TaskTriggerOutcome

Result returned when a task run is queued or rejected before execution starts.

Interfaces

IAgentTaskCatalog

Indexes file-backed tasks; the first-loaded duplicate ID wins and later entries are skipped with a warning.

IAgentTaskExecutor

Executes a single agent task run. Implemented by the consuming application because it requires app-specific dependencies (AppService, chat clients, etc.)

IAgentTaskHandler

Hooks into the standard agent task run for a reserved task key.

IAgentTaskRepository

Persists and retrieves agent task definitions and their execution run records.

IChannelNotificationService

Routes task notifications and session handoffs to a specific channel.

IDeterministicTaskHandler

Handles a reserved task end-to-end without invoking the standard agent chat pipeline.

Enums

AgentTaskStatus

Describes the lifecycle status of an agent task run.

TaskExternalParameterKind

Supported value kinds for task webhook parameters.

TaskExternalTriggerValidationFailureKind

Identifies why external task trigger parameter validation failed.

TaskNotificationMode

Controls how the user is notified after a task run completes.

TaskScheduleKind

Describes the scheduling strategy for an agent task.

TaskSessionMode

Describes whether scheduled task runs reuse conversation session state.

TaskTriggerSource

Identifies how a task run was started.