Agents

# Deploy the agent (developer key). Answers {"name", "version"}.
# Deploy each tool's workflow first.
curl -X PUT https://api.shiftlabs.org/v1/agents/billing \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{
    "title": "Billing assistant",
    "instructions": "Answer questions about invoices. Look an invoice up before you answer.",
    "model": "@cf/zai-org/glm-4.7-flash",
    "tools": [{
      "workflow": "lookup-invoice",
      "description": "Look up an invoice by its id.",
      "parameters": {
        "type": "object",
        "properties": {"invoice": {"type": "string"}},
        "required": ["invoice"]
      }
    }]
  }'

import { agent, file, project, workflowTool } from "shiftlabs";

export default project({
  workflows: { "stripe-refund": "./workflows/stripe-refund.ts" },
  agents: {
    "invoice-assistant": agent({
      title: "Invoice assistant",
      description: "Answers billing questions and issues refunds.",
      instructions: file("./agents/invoice-assistant.md"),
      model: "@cf/zai-org/glm-4.7-flash",
      tools: [workflowTool("stripe-refund", { description: "Refund an invoice.", approval: "always" })],
      budget: { conversationUsd: 0.5, monthlyUsd: 20 },
      access: { role: "developer", members: ["ana@acme.com"] },
      welcome: "Ask me about an invoice.",
      suggestions: ["Why was I charged twice?", "Refund invoice in_123"],
    }),
  },
});

import { agent, project, workflowTool } from "shiftlabs";
import * as z from "zod";

export default project({
  workflows: { "lookup-invoice": "./workflows/lookup-invoice.ts" },
  agents: {
    billing: agent({
      title: "Billing assistant",
      instructions: "Answer questions about invoices. Look an invoice up before you answer.",
      model: "@cf/zai-org/glm-4.7-flash",
      tools: [
        workflowTool("lookup-invoice", {
          description: "Look up an invoice by its id.",
          parameters: z.object({ invoice: z.string() }),
        }),
      ],
    }),
  },
});

import { tool, tools } from "shiftlabs";

export default tools({
  "save-note": tool(
    {
      description: "Save a note.",
      parameters: { type: "object", properties: { text: { type: "string" } }, required: ["text"] },
    },
    ({ text }: { text: string }, { sql }) => {
      sql.exec("CREATE TABLE IF NOT EXISTS notes (at INTEGER, text TEXT)");
      sql.exec("INSERT INTO notes (at, text) VALUES (?, ?)", Date.now(), text);
      return { saved: true };
    },
  ),
  "list-notes": tool({ description: "List the latest notes." }, (_args, { sql }) => {
    sql.exec("CREATE TABLE IF NOT EXISTS notes (at INTEGER, text TEXT)");
    return sql.exec("SELECT at, text FROM notes ORDER BY at DESC LIMIT 20").toArray();
  }),
});

import { agent, project } from "shiftlabs";

// shiftlabs deploy uploads the code, then releases the agent with it.
export default project({
  agents: {
    notes: agent({
      title: "Notes",
      instructions: "Save the notes people give you, and read them back when asked.",
      model: "@cf/zai-org/glm-4.7-flash",
      code: "./agents/notes.tools.ts",
    }),
  },
});

# Upload the code (developer key). Answers {"codeHash", "tools", "sizeBytes", "warnings"}.
curl -X PUT https://api.shiftlabs.org/v1/agents/notes/code \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" --data-binary @agents/notes.tools.ts

# Name the hash in the agent's next version. Every tool in the code joins it.
curl -X PUT https://api.shiftlabs.org/v1/agents/notes \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{
    "title": "Notes",
    "instructions": "Save the notes people give you, and read them back when asked.",
    "model": "@cf/zai-org/glm-4.7-flash",
    "code": "<codeHash>"
  }'

# Start a conversation (any role). Answers 202 {"conversation", "status": "working"}.
curl -X POST https://api.shiftlabs.org/v1/agents/billing/conversations \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{"text": "What is the status of invoice in_1QxYzExample?"}'

# Read it until its status is no longer working.
curl https://api.shiftlabs.org/v1/agents/billing/conversations/<conversation> \
  -H "authorization: Bearer $SHIFTLABS_API_KEY"

# Send the next message. Answers 202.
curl -X POST https://api.shiftlabs.org/v1/agents/billing/conversations/<conversation>/messages \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{"text": "When was it paid?"}'

# Create the app's key (admin key). agent.chat_as is in no role, so list it.
curl -X POST https://api.shiftlabs.org/v1/api-keys \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{"name": "billing-app", "role": "developer", "capabilities": ["agent.chat", "agent.chat_as"], "scope": {"agents": ["billing"]}}'

# Start a conversation for user_123. Answers 202 {"conversation", "status": "working"}.
curl -X POST https://api.shiftlabs.org/v1/agents/billing/conversations \
  -H "authorization: Bearer $APP_KEY" -H "content-type: application/json" \
  -d '{"text": "Where is my refund?", "person": "user_123"}'

# Read it, list user_123's conversations, and send the next message as user_123.
curl "https://api.shiftlabs.org/v1/agents/billing/conversations/<conversation>?person=user_123" \
  -H "authorization: Bearer $APP_KEY"
curl "https://api.shiftlabs.org/v1/agents/billing/conversations?person=user_123" \
  -H "authorization: Bearer $APP_KEY"
curl -X POST https://api.shiftlabs.org/v1/agents/billing/conversations/<conversation>/messages \
  -H "authorization: Bearer $APP_KEY" -H "content-type: application/json" \
  -d '{"text": "Thanks!", "person": "user_123"}'

# With the app's key, which holds agent.chat_as. Answers 201 {"token", "agent", "person", "expiresAt"}.
curl -X POST https://api.shiftlabs.org/v1/chat-tokens \
  -H "authorization: Bearer $APP_KEY" -H "content-type: application/json" \
  -d '{"agent": "billing", "person": "user_123", "ttl": "15 minutes"}'

const conversations = "https://api.shiftlabs.org/v1/agents/billing/conversations";
const headers = { authorization: `Bearer ${token}`, "content-type": "application/json" };

// Start a conversation as user_123, then read it until its status is no longer working.
const started = await fetch(conversations, { method: "POST", headers, body: JSON.stringify({ text: "Where is my refund?" }) });
const { conversation } = await started.json();
const reply = await (await fetch(`${conversations}/${conversation}`, { headers })).json();

# Send the next message. Answers 202.
curl -X POST https://api.shiftlabs.org/v1/agents/billing/conversations/<conversation>/messages \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{"text": "When was it paid?"}'

# Stream the answer. -N prints each event as it arrives; the stream ends when the agent is done.
curl -N https://api.shiftlabs.org/v1/agents/billing/conversations/<conversation>/stream \
  -H "authorization: Bearer $SHIFTLABS_API_KEY"

import { project, schedule } from "shiftlabs";

export default project({
  schedules: {
    "monday-summary": schedule({ agent: "billing", message: "Summarize last week's refunds.", cron: "0 9 * * 1", timezone: "America/Detroit" }),
  },
});

# Admin key. Answers {"on", "chosen", "override"}.
curl -X PUT https://api.shiftlabs.org/v1/workspace/agents \
  -H "authorization: Bearer $SHIFTLABS_API_KEY" -H "content-type: application/json" \
  -d '{"enabled": false}'