Build AI applications.Skip the infrastructure.

// An agent: a model and its instructions.
model = @ref("deepseek.deepseek-v4-flash")
prompt = "You are a friendly assistant. Keep every answer to one or two sentences."
summary = "A friendly assistant"

// A one-shot interaction: one agent, one task, one answer.
agent = {
  name = "Greeter"
  agent = @ref("greeter")
}
task = "Hello, how are you?"

import { Maitento } from "@maitento/sdk";

const mt = new Maitento();
await mt.deploy("./maitento");

const run = await mt.interactions.run("hello");
console.log(run.output);

from maitento import Maitento

mt = Maitento()
mt.deploy("./maitento")

run = mt.interactions.run("hello")
print(run.output)

using Maitento.Sdk;

await using var mt = MaitentoClient.CreateFromEnvironment();
await mt.DeployAsync("./maitento");

var run = await mt.Interactions.RunAsync("hello");
Console.WriteLine(run.Output);

connector = @ref("shop-order-get")
// Maitento sends the secret's value in this header.
// The model never sees it.
auth = {
  header = "X-Api-Key"
  secret = @ref("shop-api-key")
}
guidance = "Looks up an order: who placed it, each item and its price, the status and how much has been refunded."

agent = {
  name = "Desk"
  agent = @ref("desk-agent")
}
task = @prompt("draft-reply-task")
functions.openApi = [
  {
    name = "find-order"
    ref = @ref("find-order")
  },
  {
    name = "search-policies"
    ref = @ref("search-policies")
  }
]
// The knowledge base comes in with each run and goes
// straight into the search: the model can't choose another.
inputs.functions.binding = [
  {
    function = @ref("search-policies")
    name = "policiesId"
    target = "partitionId"
    type = "request"
  }
]

// One memory per customer, chosen by their email address.
loom = {
  enabled = true
  scope = "Input"
  scopeInput = "email"
  subjectInputs = [ "customer" ]
  recall = "Suggest"
  weave = "Manual"
}

connector = @ref("shop-order-refund")
auth = {
  header = "X-Api-Key"
  secret = @ref("shop-api-key")
}
guidance = "Refunds an order. Refund only what the policies allow, and never more than was paid for the item."
// A person approves every refund before Maitento calls it.
requiresApproval = true

agent = {
  name = "LeadResearcher"
  agent = @ref("lead-researcher")
}
task = "Compare these countries: %%countries%%. Start one country-facts interaction per country so they run in parallel, wait for them all, then write a short comparison."
// The interactions this one may start as sub-runs, and how many at once.
swarm = {
  interactions = [
    @ref("country-facts")
  ]
  maxConcurrent = 5
  maxTotal = 10
}

// The manager gets the task and hands out work.
manager = {
  name = "Editor"
  agent = @ref("editor")
}
agents = [
  {
    name = "Writer"
    agent = @ref("writer")
    // Keeps its own conversation with the editor.
    mode = "Private"
  },
  {
    name = "FactChecker"
    agent = @ref("fact-checker")
    // A fresh fact checker every time it is asked.
    mode = "OneTime"
  }
]
limits.maxDispatches = 8

string main(string namespaceName) {
  string day = DateTimeToString(DateGetUtc(), "yyyy-MM-dd");

  // Call your app through a tool: Maitento adds the secret.
  jsonObject path = JsonObjectCreate();
  path = JsonObjectSetString(path, "date", day);
  string response = ExtOpInvoke("list-tickets", "", "", path, "");

  // Save them where the capsule can read them.
  VfsWriteText("support-desk", namespaceName, "/tickets/" + day + ".json", response);

  // A throwaway Linux machine turns them into a report.
  guid capsuleId = CapsuleStart("ticket-report", namespaceName, "[]", "[]", "[]");
  jsonObject capsule = CapsuleAwait(capsuleId);

  string report = VfsReadText("support-desk", namespaceName, "/reports/latest.md");
  AppStateSetOutputString("report", report);
  return("Digest written for " + day);
}

// A throwaway Linux machine that runs a script on the day's tickets.
autoTerminate = true
maxDuration = "00:05:00"

vfs = [
  {
    vfs = @ref("support-desk")
    mountName = "desk"
  }
]

startup = [
  {
    command = "python3"
    arguments = ["/mnt/desk/count_tickets.py"]
    wait = true
    maxDuration = "00:02:00"
  }
]