cloudtifact 0.1.2 → 0.1.3

package/dist/index.js

@@ -5618,6 +5618,12 @@ function datetime(params) {
 function number(params) {
 	return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
 }
+//#endregion
+//#region ../contract/src/comment-images.ts
+/** A guest uploading an image sends their guest key under this header (the body is the image). */
+const GUEST_KEY_HEADER = "x-cloudtifact-guest-key";
+/** 128 random bits, hex. */
+const commentImageIdSchema = string().regex(/^[0-9a-f]{32}$/);
 new TextEncoder();
 //#endregion
 //#region ../contract/src/schemas.ts
@@ -5697,6 +5703,7 @@ const errorSchema = object({ error: object({
 object({
 	handle: handleSchema,
 	name: string().max(100).optional(),
+	email: email().max(200).optional(),
 	label: _enum(["cli", "web"]).default("cli")
 });
 const devLoginOutput = object({
@@ -5839,7 +5846,9 @@ const workspaceInvitePreviewOutput = object({
 	invitedBy: userSchema.nullable(),
 	memberCount: number$1().int(),
 	expiresAt: number$1(),
-	alreadyMember: boolean()
+	alreadyMember: boolean(),
+	email: string().nullable().default(null),
+	wrongAccount: boolean().default(false)
 });
 const acceptWorkspaceInviteOutput = object({ workspace: myWorkspaceSchema });
 const auditActionSchema = _enum([
@@ -5855,6 +5864,8 @@ const auditActionSchema = _enum([
 	"billing.checkout",
 	"space.created",
 	"space.updated",
+	"space.moved",
+	"space.deleted",
 	"room.link_changed",
 	"room.person_added",
 	"room.person_changed",
@@ -5933,6 +5944,11 @@ object({
 	viewers: viewersSchema.partial().optional(),
 	password: string().min(4).max(200).nullable().optional()
 });
+object({ workspace: workspaceSlugSchema });
+const moveSpaceOutput = object({
+	space: spaceSchema,
+	moved: array(spaceIdSchema)
+});
 object({ password: string().min(1).max(200) });
 const unlockSpaceOutput = object({
 	token: string(),
@@ -6113,6 +6129,12 @@ const guestIdentitySchema = object({
 	name: string().trim().min(1).max(40),
 	key: guestKeySchema
 });
+const commentImageSchema = object({
+	id: string(),
+	url: string(),
+	contentType: string(),
+	size: number$1().int()
+});
 const commentSchema = object({
 	id: string(),
 	path: string(),
@@ -6122,6 +6144,7 @@ const commentSchema = object({
 	guestName: string().nullable(),
 	origin: commentOriginSchema.nullable(),
 	body: string(),
+	images: array(commentImageSchema).default([]),
 	quote: string().nullable(),
 	anchor: anchorSchema.nullable(),
 	via: string().nullable(),
@@ -6144,6 +6167,30 @@ object({
 	]).default("open")
 });
 const listCommentsOutput = object({ threads: array(threadSchema) });
+object({
+	before: number().int().positive().optional(),
+	limit: number().int().min(1).max(50).default(20)
+});
+const waitingOutput = object({
+	threads: array(object({
+		thread: threadSchema,
+		space: object({
+			id: string(),
+			name: string(),
+			path: string(),
+			kind: _enum([
+				"repo",
+				"room",
+				"app"
+			])
+		}),
+		reason: _enum(["participant", "owner"]),
+		lastAt: number$1()
+	})),
+	total: number$1().int(),
+	spaces: number$1().int(),
+	next: number$1().nullable()
+});
 object({
 	body: string().min(1).max(1e4),
 	guest: object({ key: guestKeySchema }).optional()
@@ -6163,6 +6210,7 @@ object({
 	anchor: anchorSchema.optional(),
 	parentId: string().optional(),
 	versionNumber: number$1().int().optional(),
+	images: array(commentImageIdSchema).max(4).optional(),
 	guest: guestIdentitySchema.optional()
 });
 const DB_MAX_SQL_BYTES = 102400;
@@ -6475,7 +6523,9 @@ const ownerLinkOutput = object({
 const planIdSchema = _enum([
 	"free",
 	"pro",
+	"pro_annual",
 	"team",
+	"team20",
 	"enterprise"
 ]);
 const usageShape = {
@@ -6508,7 +6558,9 @@ const billingOutput = object({
 object({ plan: _enum([
 	"free",
 	"pro",
-	"team"
+	"pro_annual",
+	"team",
+	"team20"
 ]) });
 const checkoutOutput = object({ url: string() });
 const portalOutput = object({ url: string() });
@@ -6593,6 +6645,8 @@ function createClient({ baseUrl, token, fetch: fetchImpl = fetch, agent, source,
 		createSpace: (input) => call("POST", "/v1/spaces", spaceSchema, input),
 		getSpace: (id) => call("GET", space(id), spaceSchema),
 		updateSpace: (id, input) => call("PATCH", space(id), spaceSchema, input),
+		deleteSpace: (id) => call("DELETE", space(id), null),
+		moveSpace: (id, input) => call("POST", `${space(id)}/move`, moveSpaceOutput, input),
 		head: (id) => call("GET", `${space(id)}/head`, headOutput),
 		unlockSpace: (id, input) => call("POST", `${space(id)}/unlock`, unlockSpaceOutput, input),
 		recordView: (id, input) => call("POST", `${space(id)}/views`, null, input),
@@ -6637,7 +6691,19 @@ function createClient({ baseUrl, token, fetch: fetchImpl = fetch, agent, source,
 			if (query.status) q.set("status", query.status);
 			return call("GET", `${space(id)}/comments${q.size ? `?${q}` : ""}`, listCommentsOutput);
 		},
+		waiting: (slug, query = {}) => {
+			const q = new URLSearchParams();
+			if (query.before) q.set("before", String(query.before));
+			if (query.limit) q.set("limit", String(query.limit));
+			return call("GET", `/v1/workspaces/${enc$1(slug)}/waiting${q.size ? `?${q}` : ""}`, waitingOutput);
+		},
 		createComment: (id, input) => call("POST", `${space(id)}/comments`, commentSchema, input),
+		/** Uploads an image for a comment; post it with createComment's `images`. A guest passes their key. */
+		uploadCommentImage: (id, body, opts) => call("POST", `${space(id)}/comment-images`, commentImageSchema, body, {
+			"content-type": opts.contentType || "application/octet-stream",
+			"content-length": String(opts.size),
+			...opts.guestKey ? { [GUEST_KEY_HEADER]: opts.guestKey } : {}
+		}),
 		editComment: (commentId, input) => call("PATCH", `/v1/comments/${enc$1(commentId)}`, commentSchema, input),
 		commentRevisions: (commentId) => call("GET", `/v1/comments/${enc$1(commentId)}/revisions`, commentRevisionsOutput),
 		deleteComment: (commentId, input = {}) => call("DELETE", `/v1/comments/${enc$1(commentId)}`, null, input),
@@ -6674,6 +6740,13 @@ function createClient({ baseUrl, token, fetch: fetchImpl = fetch, agent, source,
 		deleteMessage: (roomId, messageId) => send("DELETE", `${room(roomId)}/messages/${enc$1(messageId)}`),
 		listSources: (id) => call("GET", `${room(id)}/sources`, listSourcesOutput),
 		uploadSource: (id, name, bytes, contentType) => call("POST", `${room(id)}/sources?name=${enc$1(name)}`, sourceSchema, bytes, { "content-type": contentType }),
+		/** A source file's bytes as an attachment (the raw Response, to stream or save). */
+		downloadSource: (id, sourceId) => request("GET", `${room(id)}/sources/${enc$1(sourceId)}/raw`),
+		/** Uploads an image for an image block in the room's doc; put its `url` in the block's src. */
+		uploadRoomImage: (id, body, opts) => call("POST", `${room(id)}/images`, commentImageSchema, body, {
+			"content-type": opts.contentType || "application/octet-stream",
+			"content-length": String(opts.size)
+		}),
 		updateSource: (id, sourceId, input) => call("PATCH", `${room(id)}/sources/${enc$1(sourceId)}`, sourceSchema, input),
 		deleteSource: (id, sourceId) => call("DELETE", `${room(id)}/sources/${enc$1(sourceId)}`, null),
 		listApps: (query = {}) => {
@@ -10521,7 +10594,8 @@ function commentsData(threads, opts) {
 		edited: c.editedBy ? `${c.editedBy.handle}${c.editedVia ? ` via ${c.editedVia}` : ""}` : null,
 		status: t.resolvedAt === null ? "open" : "resolved",
 		quote: c.quote,
-		body: c.body
+		body: c.body,
+		images: c.images?.length ? c.images.map((i) => i.url).join(" ") : null
 	})));
 	return {
 		space: opts.spaceUrl ?? null,
@@ -11466,6 +11540,8 @@ const from = (c) => {
 };
 const who = (c) => (c.guestName ? `${c.guestName} (guest)` : `@${c.author.handle}${c.via ? ` via ${agentLabel(c.via)}` : ""}`) + from(c);
 const edited = (c) => c.editedBy ? ` (edited by @${c.editedBy.handle}${c.editedVia ? ` via ${agentLabel(c.editedVia)}` : ""}; \`cloudtifact history ${c.id}\`)` : "";
+/** A comment's images as Markdown image links (an agent can fetch them), then a blank line; nothing if none. */
+const images = (c) => c.images?.length ? [...c.images.map((img, i) => `![Image ${i + 1}](${img.url})`), ""] : [];
 /** Open threads as Markdown an agent can act on directly. */
 function threadsToMarkdown(threads, opts) {
 	const spaceFlag = opts.defaultSpace ? "" : ` --space ${opts.spaceId}`;
@@ -11482,8 +11558,8 @@ function threadsToMarkdown(threads, opts) {
 			out.push(`### Comment \`${t.id}\`${status}`, "");
 			out.push(`${who(t)} on v${t.versionNumber}, ${when(t.createdAt)}${edited(t)}:`, "");
 			if (t.quote) out.push("On this text:", "", quote(t.quote), "");
-			out.push(t.body.trim(), "");
-			for (const r of t.replies) out.push(`- Reply \`${r.id}\` from ${who(r)} (${when(r.createdAt)})${edited(r)}:`, "", r.body.trim().replace(/^/gm, "  "), "");
+			out.push(t.body.trim(), "", ...images(t));
+			for (const r of t.replies) out.push(`- Reply \`${r.id}\` from ${who(r)} (${when(r.createdAt)})${edited(r)}:`, "", r.body.trim().replace(/^/gm, "  "), "", ...images(r).map((l) => l ? `  ${l}` : l));
 			out.push("To answer and close it:", "", "```sh", `cloudtifact reply ${t.id}${spaceFlag} "<what you changed>"`, t.resolvedAt ? `cloudtifact unresolve ${t.id}` : `cloudtifact resolve ${t.id}`, "```", "");
 		}
 	}
@@ -11840,6 +11916,10 @@ When you make an HTML page for the user, run \`cloudtifact publish <file.html>\`
 - Keep supporting files next to the HTML (or in subfolders) and reference them with relative paths (\`style.css\`, \`img/logo.png\`). Absolute paths and files outside the page's folder aren't included.
 - Pages are private by default; add \`--public\` on the first publish for a link anyone can open. \`cloudtifact artifacts\` lists what you've published.
 
+## Space files
+
+People can add files to a space for the work (chat exports, emails, PDFs, spreadsheets, screenshots and other images). \`cloudtifact sources --space <id> --toon\` lists them; \`cloudtifact download --source "<name or id>" --space <id>\` saves one locally so you can read it. Open downloaded images to look at them.
+
 ## Workspaces
 
 Spaces live in workspaces (personal or team; the user can belong to several). \`cloudtifact publish\` and \`cloudtifact init\` create new spaces in the current workspace and print which one; pass \`--workspace <slug>\` to pick another. \`cloudtifact workspace list\` shows the user's workspaces (current one marked); \`cloudtifact workspace use <slug>\` switches the default. Pushing to an existing space doesn't need a workspace. Only change the default when the user asks.
@@ -12009,6 +12089,13 @@ function findUpload(uploads, ref) {
 	const names = uploads.slice(0, 10).map((u) => `  ${u.name}  (${u.id})`);
 	throw new CliError(uploads.length ? `No upload named or with id "${ref}". Uploads in this space:\n${names.join("\n")}` : "This space has no uploads.");
 }
+/** A file in a space's "Files the AI reads" by id, else the newest one with that exact name. */
+function findSource(sources, ref) {
+	const hit = sources.find((s) => s.id === ref) ?? sources.find((s) => s.name === ref);
+	if (hit) return hit;
+	const names = sources.slice(0, 10).map((s) => `  ${s.name}  (${s.id})`);
+	throw new CliError(sources.length ? `No file named or with id "${ref}" in this space. Its files:\n${names.join("\n")}` : "This space has no files for the AI.");
+}
 /**
 * Streams a download to `dest` (via a temp file, renamed at the end), checking the SHA-256 the API sent.
 * Refuses to overwrite unless `force`.
@@ -12116,7 +12203,7 @@ function workspaceTextLines(workspaces, currentSlug) {
 }
 //#endregion
 //#region src/program.ts
-const VERSION = "0.1.2";
+const VERSION = "0.1.3";
 const program = new Command().name("cloudtifact").description("Publish pages and docs to Cloudtifact as links people comment on, with every version kept and the comments handed back to your agent.").version(VERSION);
 program.command("login").description("Sign in through your browser (GitHub, Google or email) and save a token to the global config").option("--no-browser", "don't open a browser, just print the URL (automatic over SSH)").action(run(async (opts) => {
 	const config = await readGlobalConfig();
@@ -12611,13 +12698,40 @@ program.command("uploads").description("List the files uploaded to a space, newe
 	if (!rows.length) return console.log("No uploads yet. Add some with `cloudtifact upload <files...>`.");
 	for (const r of rows) console.log(`${r.id}  ${r.at} UTC  ${(r.size / 1024 / 1024).toFixed(1).padStart(6)} MB  ${r.name}`);
 }));
-program.command("download").description("Download an uploaded file (by name or id), or a pushed file with --file").argument("[name]", "the upload's name or id").option("--file <path>", "download a pushed file instead (path in the space)").option("--version <n>", "with --file: the version to download from (default: latest)").option("-o, --output <path>", "where to save it (default: the file's name, in the current folder)").option("--force", "overwrite an existing file").option("--space <id>", "space id or link (default: the first target in .cloudtifact.json)").action(run(async (name, opts) => {
-	if (!name && !opts.file) throw new CliError("Name an upload (see `cloudtifact uploads`), or pass --file <path>.");
+program.command("sources").description("List a space's \"Files the AI reads\" (chats, emails, PDFs, images...); get one with download --source").option("--space <id>", "space id or link (default: the first target in .cloudtifact.json)").option("--toon", "print TOON (compact, for agents)").option("--json", "print JSON").action(run(async (opts) => {
+	const { spaceId } = await pickSpace(opts.space, { noRepo: "Pass --space <id>, or run inside a linked repo." });
+	const { client } = await getClient({ auth: false });
+	const { sources } = await client.listSources(spaceId);
+	const rows = sources.map((s) => ({
+		id: s.id,
+		name: s.name,
+		type: s.contentType,
+		size: s.size,
+		status: s.status,
+		summary: s.summary,
+		by: s.uploadedBy?.handle ?? null,
+		at: new Date(s.createdAt).toISOString().slice(0, 16).replace("T", " ")
+	}));
+	const format = resolveFormat(opts);
+	if (format !== "text") return printData(format, {
+		spaceId,
+		sources: rows
+	});
+	if (!rows.length) return console.log("No files yet. People add them in the space's Files panel.");
+	for (const r of rows) console.log(`${r.id}  ${r.at} UTC  ${(r.size / 1024 / 1024).toFixed(1).padStart(6)} MB  ${r.name}  (${r.summary ?? r.status})`);
+	console.log("\nDownload one with `cloudtifact download --source \"<name or id>\"`.");
+}));
+program.command("download").description("Download an uploaded file (by name or id), a pushed file with --file, or a space file with --source").argument("[name]", "the upload's name or id").option("--file <path>", "download a pushed file instead (path in the space)").option("--source <name>", "download one of the space's \"Files the AI reads\" instead (name or id; see `sources`)").option("--version <n>", "with --file: the version to download from (default: latest)").option("-o, --output <path>", "where to save it (default: the file's name, in the current folder)").option("--force", "overwrite an existing file").option("--space <id>", "space id or link (default: the first target in .cloudtifact.json)").action(run(async (name, opts) => {
+	if (!name && !opts.file && !opts.source) throw new CliError("Name an upload (see `cloudtifact uploads`), or pass --file <path> or --source <name>.");
 	const { spaceId } = await pickSpace(opts.space, { noRepo: "Pass --space <id>, or run inside a linked repo." });
 	const { client } = await getClient({ auth: false });
 	let res;
 	let fallback;
-	if (opts.file) {
+	if (opts.source) {
+		const source = findSource((await client.listSources(spaceId)).sources, opts.source);
+		res = await client.downloadSource(spaceId, source.id);
+		fallback = source.name;
+	} else if (opts.file) {
 		const v = opts.version ? Number(opts.version) : void 0;
 		if (v !== void 0 && !(Number.isInteger(v) && v > 0)) throw new CliError("--version must be a positive integer.");
 		res = await client.downloadFile(spaceId, opts.file, v);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudtifact",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Publish pages and docs to Cloudtifact as links people comment on, with every version kept and the comments handed back to your agent.",
   "license": "MIT",
   "author": "The Cloudtifact authors",