Agent service runtime

// service.ts
import { startNodeVeryfrontCloudAgentService } from "veryfront/agent";

await startNodeVeryfrontCloudAgentService();

// agents/support.ts
import { agent } from "veryfront/agent";

export default agent({
  id: "support",
  system: "You help users resolve support issues.",
  tools: {
    searchDocs: true,
  },
});

---
name: Support
description: Helps users resolve support issues
max-steps: 6
---

You help users resolve support issues. Ask for missing details before acting.

VERYFRONT_API_URL=https://api.example.com
VERYFRONT_API_TOKEN=<TOKEN>
VERYFRONT_PROJECT_ID=<PROJECT_ID>
VERYFRONT_AGENT_SERVICE_URL=https://agent.example.com
VERYFRONT_AGENT_SERVICE_REGISTRATION=auto

import { startNodeVeryfrontCloudAgentService } from "veryfront/agent";

const environmentName = process.env.DEPLOYED_ENVIRONMENT_NAME;
const releaseId = process.env.DEPLOYED_RELEASE_ID;
if (!environmentName || !releaseId) {
  throw new Error("Missing immutable agent service deployment identity");
}

await startNodeVeryfrontCloudAgentService({
  runtimeSource: {
    type: "environment",
    environmentName,
    releaseId,
  },
});

import {
  startNodeVeryfrontCloudAgentService,
  veryfrontApiMcpServer,
  veryfrontStudioMcpServer,
} from "veryfront/agent";

await startNodeVeryfrontCloudAgentService({
  serviceName: "support-agent",
  mcpServers: [
    veryfrontApiMcpServer(),
    veryfrontStudioMcpServer(),
    {
      id: "linear",
      endpoint: process.env.LINEAR_MCP_URL,
      headers: {
        Authorization: ["Bearer", "<TOKEN>"].join(" "),
      },
      toolPolicy: {
        allow: ["search_issues", "create_issue"],
        approval: "never",
      },
    },
  ],
});

import {
  startNodeVeryfrontCloudAgentService,
  veryfrontApiMcpServer,
  veryfrontStudioMcpServer,
} from "veryfront/agent";
import { createRemoteMCPToolSourceFactoryWithTransport } from "veryfront/tool";

function requiredUrl(name: string): string {
  const value = process.env[name];
  if (!value) throw new Error(`Missing ${name}`);
  return value;
}

const hostFetch = globalThis.fetch.bind(globalThis);
const createRemoteToolSource = createRemoteMCPToolSourceFactoryWithTransport({
  trustedEndpoints: [
    requiredUrl("VERYFRONT_MCP_URL"),
    requiredUrl("VERYFRONT_STUDIO_MCP_URL"),
  ],
  requestFetch: hostFetch,
});

await startNodeVeryfrontCloudAgentService({
  createRemoteToolSource,
  mcpServers: [
    veryfrontApiMcpServer(),
    veryfrontStudioMcpServer(),
  ],
});

import { agent } from "veryfront/agent";

export default agent({
  id: "support",
  system: "You are a support assistant.",
  resolveRuntimeState: async ({ step }) => {
    if (step === 0) return;

    return {
      system: "Use the latest project instructions and tool inventory.",
    };
  },
});

{
  "version": 1,
  "mode": "project-tools",
  "binding": {
    "allocationId": "allocation-example",
    "generation": 1,
    "invocationId": "invocation-example"
  },
  "owner": { "scopeKind": "project", "projectId": "project-example" },
  "source": { "type": "release", "releaseId": "release-example" },
  "root": "project",
  "context": {
    "agentId": "assistant",
    "projectId": "project-example",
    "runId": "run-example"
  },
  "allowedToolNames": ["inspect"],
  "maxCalls": 32,
  "maxConcurrent": 2
}

deno task build:npm
deno task test:e2e:managed-broker

node service.ts &
curl -N http://localhost:3001/api/runs \
  -H "Content-Type: application/json" \
  -d '{"agentId":"support","messages":[{"id":"1","role":"user","parts":[{"type":"text","text":"ping"}]}]}'