@alfe.ai/agent-api-client 0.6.0 → 0.7.0

package/dist/index.js

@@ -14,6 +14,8 @@ const RETRYABLE_STATUS = new Set([
 	504
 ]);
 const RETRY_DELAY_MS = 500;
+const IMAGE_POLL_INTERVAL_MS = 2e3;
+const IMAGE_JOB_TIMEOUT_MS = 18e4;
 function sleep(ms) {
 	return new Promise((resolve) => {
 		setTimeout(resolve, ms);
@@ -591,36 +593,50 @@ var AgentApiClient = class {
 	}
 	/**
 	* Generate an image from a text prompt and get back a STABLE, public URL
-	* (served from the agent-assets CDN — it does not expire). The image is
-	* generated + stored server-side; embed the returned `imageUrl` in a reply as
-	* markdown to show it to the user.
+	* (served from the agent-assets CDN — it does not expire). Embed the returned
+	* `imageUrl` in a reply as markdown to show it to the user.
 	*
-	* Unlike most methods this reads the server's error body so a bad-request
-	* detail (e.g. an unsupported `size`) reaches the caller instead of an opaque
-	* "request failed (400)". Not retried — generation is expensive and
-	* non-idempotent.
+	* ASYNC: `gpt-image-1` routinely runs 30–60s, which exceeds the API Gateway
+	* 30s ceiling, so this enqueues a job (`POST /agent/images/generate` →
+	* `jobId`) then polls (`GET /agent/images/{jobId}`) until it completes. The
+	* worker's real failure message (e.g. an unsupported `size`) surfaces via the
+	* job's `error` field.
 	*/
 	async generateImage(args) {
 		const headers = new Headers();
 		headers.set("Authorization", `Bearer ${this.apiKey}`);
 		headers.set("Content-Type", "application/json");
-		const res = await fetch(`${this.apiUrl}/agent/images/generate`, {
+		const enqueueRes = await fetch(`${this.apiUrl}/agent/images/generate`, {
 			method: "POST",
 			headers,
 			body: JSON.stringify(args),
-			signal: AbortSignal.timeout(33e3)
+			signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
 		});
-		if (!res.ok) {
-			const body = await res.text().catch(() => "");
-			let detail = "";
+		if (!enqueueRes.ok) throw new Error(`Image generation failed to start (${String(enqueueRes.status)})`);
+		const { data: enqueued } = await enqueueRes.json();
+		const jobId = enqueued.jobId;
+		const deadline = Date.now() + IMAGE_JOB_TIMEOUT_MS;
+		while (Date.now() < deadline) {
+			await sleep(IMAGE_POLL_INTERVAL_MS);
+			let job;
 			try {
-				const parsed = JSON.parse(body);
-				const msg = typeof parsed.message === "string" ? parsed.message : typeof parsed.error === "string" ? parsed.error : "";
-				if (msg) detail = `: ${msg}`;
-			} catch {}
-			throw new Error(`Image generation failed (${String(res.status)})${detail}`);
+				job = await this.request(`/agent/images/${jobId}`);
+			} catch {
+				continue;
+			}
+			if (job.status === "completed") {
+				if (!job.imageUrl) throw new Error("Image generation completed without a URL");
+				return {
+					imageUrl: job.imageUrl,
+					model: job.model ?? args.model ?? "gpt-image-1"
+				};
+			}
+			if (job.status === "failed") {
+				const detail = job.error ? `: ${job.error.split("\n")[0]}` : "";
+				throw new Error(`Image generation failed${detail}`);
+			}
 		}
-		return (await res.json()).data;
+		throw new Error("Image generation timed out");
 	}
 	async recordActivity(data) {
 		return this.request("/agent/activity", {
@@ -979,30 +995,6 @@ var AgentApiClient = class {
 	async getScopeProfile(scopeType, scopeId) {
 		return this.request(`/agent/org/profile/${encodeURIComponent(scopeType)}/${encodeURIComponent(scopeId)}`);
 	}
-	/** List a scope's facts (non-semantic, full enumeration). */
-	async listScopeFacts(scopeType, scopeId, opts) {
-		const qs = new URLSearchParams();
-		if (opts?.limit !== void 0) qs.set("limit", String(opts.limit));
-		if (opts?.cursor) qs.set("cursor", opts.cursor);
-		const query = qs.toString();
-		return this.request(`/agent/org/facts/${encodeURIComponent(scopeType)}/${encodeURIComponent(scopeId)}${query ? `?${query}` : ""}`);
-	}
-	/**
-	* Publish a fact at a scope. This is the deliberate cross-agent learning
-	* boundary — facts are attributable (the agent is recorded as author) and
-	* never an automatic merge. Membership is enforced server-side (403 for a
-	* non-member scope).
-	*/
-	async createScopeFact(scopeType, scopeId, text) {
-		return this.request(`/agent/org/facts/${encodeURIComponent(scopeType)}/${encodeURIComponent(scopeId)}`, {
-			method: "POST",
-			body: JSON.stringify({ text })
-		});
-	}
-	/** Delete a fact at a scope. */
-	async deleteScopeFact(scopeType, scopeId, factId) {
-		return this.request(`/agent/org/facts/${encodeURIComponent(scopeType)}/${encodeURIComponent(scopeId)}/${encodeURIComponent(factId)}`, { method: "DELETE" });
-	}
 	/** List a scope's docs (the org-files corpus; mirrored to shared/<scope>/). */
 	async listScopeDocs(scopeType, scopeId, opts) {
 		const qs = new URLSearchParams();
@@ -1058,6 +1050,55 @@ var AgentApiClient = class {
 		}
 		return { filePath: presign.filePath };
 	}
+	/**
+	* Open a change request against a scope's knowledge resource. For a doc
+	* create/update, `services/org` returns a presigned staging PUT; this method
+	* uploads the proposed `content` to it (echoing the same Content-Type that
+	* was signed), mirroring `writeScopeDoc`. The staged body is applied to the
+	* canonical doc — attributed to this agent — only when a reviewer approves.
+	*/
+	async proposeScopeChange(scopeType, scopeId, input) {
+		const isDocBody = input.resourceType === "doc" && input.operation !== "delete";
+		const contentType = input.contentType ?? "text/markdown";
+		const result = await this.request(`/agent/org/change-requests/${encodeURIComponent(scopeType)}/${encodeURIComponent(scopeId)}`, {
+			method: "POST",
+			body: JSON.stringify({
+				resourceType: input.resourceType,
+				operation: input.operation,
+				rationale: input.rationale,
+				targetPath: input.targetPath,
+				proposedContentType: isDocBody ? contentType : void 0,
+				proposedValue: input.proposedValue
+			})
+		});
+		if (isDocBody && result.uploadUrl) {
+			const putHeaders = new Headers(result.requiredHeaders ?? {});
+			putHeaders.set("Content-Type", contentType);
+			const res = await fetch(result.uploadUrl, {
+				method: "PUT",
+				body: input.content ?? "",
+				headers: putHeaders,
+				signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+			});
+			if (!res.ok) {
+				await res.text();
+				throw new Error(`Change-request body upload failed (${String(res.status)})`);
+			}
+		}
+		return result.changeRequest;
+	}
+	/**
+	* List the agent's OWN change requests in a scope (filtered server-side to
+	* this agent as proposer). Pass `status` to narrow to open / approved / etc.
+	*/
+	async listScopeChangeRequests(scopeType, scopeId, opts) {
+		const qs = new URLSearchParams();
+		if (opts?.status) qs.set("status", opts.status);
+		if (opts?.limit !== void 0) qs.set("limit", String(opts.limit));
+		if (opts?.cursor) qs.set("cursor", opts.cursor);
+		const query = qs.toString();
+		return this.request(`/agent/org/change-requests/${encodeURIComponent(scopeType)}/${encodeURIComponent(scopeId)}${query ? `?${query}` : ""}`);
+	}
 	async registerDatabaseCredentials() {
 		return this.request("/agent/database/register", { method: "POST" });
 	}