The agent SDK where humans drive the state.

from onto import Onto, Models, BuiltinTools

onto = Onto(model=Models.GPT_OSS_20B,
            builtin_tools=BuiltinTools.STANDARD)

# 1. Extract typed facts from a single sentence.
result = onto.run_sync(
    "Hi, I'm Alice. UTC, mornings. Plan a Lyon trip.",
    user_id="alice",
    consent_scopes=["memory:write"],
    extract=True,
)

# 2. Plan only — no side-effectful tools fire.
plan = onto.run_sync(
    "Plan the trip.",
    user_id="alice",
    mode="plan_only",
    consent_scopes=["tasks:write"],
)

# 3. Human approves, then we execute.
if human_approves(plan):
    onto.run_sync(
        "Run the approved plan.",
        user_id="alice",
        consent_scopes=["tasks:read", "tools:web.fetch"],
    )

import { Onto, Models, BuiltinTools } from "@onto/core";

const onto = new Onto({
  model: Models.GPT_OSS_20B,
  builtinTools: BuiltinTools.STANDARD,
});

// 1. Extract typed facts from a single sentence.
await onto.run("Hi, I'm Alice. UTC, mornings. Plan a Lyon trip.", {
  userId: "alice",
  consentScopes: ["memory:write"],
  extract: true,
});

// 2. Plan only — no side-effectful tools fire.
const plan = await onto.run("Plan the trip.", {
  userId: "alice",
  mode: "plan_only",
  consentScopes: ["tasks:write"],
});

// 3. Human approves, then we execute.
if (await humanApproves(plan)) {
  await onto.run("Run the approved plan.", {
    userId: "alice",
    consentScopes: ["tasks:read", "tools:web.fetch"],
  });
}

use onto_runtime::{Onto, Models, BuiltinTools, RunOpts, Mode};

let onto = Onto::builder()
    .model(Models::GPT_OSS_20B)
    .builtin_tools(BuiltinTools::STANDARD)
    .build()
    .await?;

// 1. Extract typed facts from a single sentence.
onto.run("Hi, I'm Alice. UTC, mornings. Plan a Lyon trip.",
    RunOpts::new("alice")
        .consent_scopes(["memory:write"])
        .extract(true),
).await?;

// 2. Plan only — no side-effectful tools fire.
let plan = onto.run("Plan the trip.",
    RunOpts::new("alice")
        .mode(Mode::PlanOnly)
        .consent_scopes(["tasks:write"]),
).await?;

// 3. Human approves, then we execute.
if human_approves(&plan) {
    onto.run("Run the approved plan.",
        RunOpts::new("alice")
            .consent_scopes(["tasks:read", "tools:web.fetch"]),
    ).await?;
}