johnandersen777.bsky.social/atlibs-agents

Switch repository

Loading…

{
	"lexicon": 1,
	"id": "com.fedfork.agents.launchAgent",
	"defs": {
		"main": {
			"type": "procedure",
			"description": "Launch an atirc agent on a socialweb.computer VM as the service's account (atlibs-agents service/). The guest runs `atirc agent run` (the caller cannot change the command); the service shuts the launch down when its token expires, and a caller may have a few launches at a time (429 RateLimitExceeded past that). Answers once the com.fedfork.agents.launch record exists; the VM, the atirc token and the agent come up in the background (getAgent shows them).",
			"input": {
				"encoding": "application/json",
				"schema": {
					"type": "object",
					"properties": {
						"name": { "type": "string", "maxLength": 14, "description": "atirc label (default agent)." },
						"via": { "type": "string", "knownValues": ["iroh", "webrtc"] },
						"bidders": { "type": "array", "maxLength": 8, "items": { "type": "string", "format": "did" }, "description": "Must pass the composition's allow-bidders policy." },
						"exp_s": { "type": "integer", "minimum": 60, "maximum": 86400, "description": "atirc token and launch lifetime (default 7200)." }
					}
				}
			},
			"output": {
				"encoding": "application/json",
				"schema": {
					"type": "object",
					"required": ["rkey", "uri", "status"],
					"properties": {
						"rkey": { "type": "string", "description": "The launch id." },
						"uri": { "type": "string", "format": "at-uri" },
						"status": { "type": "string" },
						"subhandle": { "type": "string" }
					}
				}
			},
			"errors": [{ "name": "InvalidRequest" }, { "name": "AuthenticationRequired" }, { "name": "RateLimitExceeded" }]
		}
	}
}