Interface: AgentOptions

import { Agent } from "cognitio-agent-sdk"

const agent = new Agent({ model: "anthropic/claude-sonnet-4-5", spawn: {} })
try {
  const result = await agent.run("Summarize this repository.")
  console.log(result.text)
} finally {
  await agent.close() // explicit spawn options give this Agent its own runtime
}

optional agents?: Record<string, AgentDefinition>;

optional allowedTools?: string[];

optional appendSystemPrompt?: string;

optional autoPermissionClassifierModel?: ModelId;

optional backgroundTaskPolicy?: object;

mode: "foreground";

optional baseUrl?: string;

optional canUseTool?: false | CanUseToolCallback;

optional checkpointing?: CheckpointingConfig;

optional client?: AgentClient;

optional commands?: CommandDefinition[];

optional compaction?: object;

optional auto?: boolean;

optional includeFiles?: boolean;

optional control?: ControlOptions;

optional cwd?: string;

optional deleteSessionsOnClose?: boolean;

optional directory?: string;

optional disallowedTools?: string[];

optional effort?: "high" | "medium" | "low" | "max";

optional enableFileCheckpointing?: boolean;

optional enableToolSearch?: boolean | "always" | "auto" | "never";

optional headers?: Record<string, string>;

optional hooks?: HookRegistration;

optional includeEnvironment?: boolean;

optional instructions?: string;

optional maxBudgetUsd?: number;

optional maxTurns?: number;

optional model?: ModelId;

optional outputFormat?: OutputFormatSpec<unknown>;

optional permission?: PermissionRuleset;

optional permissionMode?: PermissionMode;

optional plugins?: PluginSpec[];

optional sdkMcpServers?: RuntimeMcpServer[];

optional settingSources?: ("user" | "local" | "project")[];

optional skills?: SkillDefinition[];

optional spawn?: SpawnOptions;

optional systemPrompt?: SystemPromptSpec;

optional thinkingConfig?: ThinkingConfig;

optional title?: string;

optional tools?: ToolDefinition[];

optional workspaceId?: string;