johnandersen777.bsky.social/atlibs-agents

Switch repository

Loading…

{
	"lexicon": 1,
	"id": "com.fedfork.agents.launch",
	"defs": {
		"main": {
			"type": "record",
			"key": "tid",
			"description": "An atirc agent launched on a socialweb.computer VM by the agents module (atlibs-agents modules/agents). The record key is the launch id: the agent's atirc subhandle is <name>-<rkey>.<handle>, and shutdown takes the rkey. Never holds the atirc token.",
			"record": {
				"type": "object",
				"required": ["name", "status", "bidders", "via", "agent", "createdAt"],
				"properties": {
					"name": { "type": "string", "maxLength": 14, "description": "The atirc label: a-z 0-9 -, starting with a letter." },
					"status": { "type": "string", "knownValues": ["launching", "running", "stopped", "failed"] },
					"bidders": { "type": "array", "maxLength": 8, "items": { "type": "string", "format": "did" } },
					"via": { "type": "string", "knownValues": ["iroh", "webrtc"], "description": "How the ssh command that starts the agent reached the guest." },
					"agent": { "type": "string", "maxLength": 1024, "description": "The command the agent unit runs as the nick user (default: atirc agent run, the account's stored harness)." },
					"subhandle": { "type": "string", "description": "The agent's atirc subhandle, minted with chat.atirc.mint." },
					"nick": { "type": "string" },
					"receipt": {
						"type": "object",
						"description": "The winning bidder's market.receipt strong ref and its submitEvent route.",
						"required": ["uri", "cid"],
						"properties": { "uri": { "type": "string", "format": "at-uri" }, "cid": { "type": "string", "format": "cid" }, "submitEvent": { "type": "string" } }
					},
					"bidder": { "type": "string", "format": "did" },
					"caller": { "type": "string", "format": "did", "description": "Who launched it, when a service launches for other accounts (the verified service-auth issuer); only it may read or shut the agent down." },
					"records": {
						"type": "object",
						"description": "The market round's records in this repo, deleted at shutdown.",
						"properties": { "vm": { "type": "string", "format": "at-uri" }, "rfp": { "type": "string", "format": "at-uri" }, "accept": { "type": "string", "format": "at-uri" } }
					},
					"error": { "type": "string", "maxLength": 3000 },
					"createdAt": { "type": "string", "format": "datetime" },
					"updatedAt": { "type": "string", "format": "datetime" }
				}
			}
		}
	}
}