@hitch42/applet 0.1.0-beta.2 → 0.1.0-beta.9

package/dist/index.js

@@ -1,5 +1,7 @@
 import { i as registerHitchContract, t as uploadFile } from "./upload-DRbVhuDm.js";
-import { n as appletManifestSchema, r as appletSourceDefinitionSchema, t as appletDefinitionSchema } from "./manifest-DyoJ1MIL.js";
+import { a as emailTagsSchema, c as listEmailTrackersInputSchema, d as markEmailTrackerSentInputSchema, i as emailTagKeySchema, l as listEmailTrackersOutputSchema, n as createEmailPixelOutputSchema, o as emailTrackerSchema, r as emailContract, s as getEmailTrackerInputSchema, t as createEmailPixelInputSchema } from "./email-DBTVhNB_.js";
+import { n as meSchema, t as meContract } from "./me-BW7Paary.js";
+import { n as appletManifestSchema, r as appletSourceDefinitionSchema, t as appletDefinitionSchema } from "./manifest-Bp87Uz0a.js";
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 //#region src/hitch/contract.ts
@@ -78,34 +80,147 @@ const filesContract = {
 	}).input(fileIdInputSchema).output(getFileOutputSchema)
 };
 //#endregion
-//#region src/hitch/me.ts
-const personSchema = z.object({
+//#region src/hitch/telephony.ts
+const hitchPhoneNumberSchema = z.object({
 	id: z.uuid(),
-	firstName: z.string(),
-	lastName: z.string(),
-	email: z.email()
+	e164: z.string(),
+	label: z.string(),
+	enabled: z.boolean(),
+	canRead: z.boolean(),
+	canSend: z.boolean(),
+	canCall: z.boolean(),
+	voiceEnabled: z.boolean()
+});
+const hitchCallSchema = z.object({
+	id: z.uuid(),
+	numberId: z.uuid(),
+	direction: z.enum(["inbound", "outbound"]),
+	status: z.enum([
+		"starting",
+		"ringing",
+		"active",
+		"ended",
+		"missed",
+		"failed"
+	]),
+	from: z.string(),
+	to: z.string(),
+	userId: z.uuid().nullable(),
+	answeredAt: z.string().nullable(),
+	endedAt: z.string().nullable(),
+	durationSeconds: z.number().nullable(),
+	voicemailSeconds: z.number().nullable(),
+	hangupCause: z.string().nullable(),
+	record: z.boolean(),
+	hasRecording: z.boolean(),
+	transcriptStatus: z.enum([
+		"pending",
+		"done",
+		"failed"
+	]).nullable(),
+	transcript: z.object({ segments: z.array(z.object({
+		side: z.enum(["member", "customer"]),
+		speaker: z.number(),
+		start: z.number(),
+		end: z.number(),
+		text: z.string()
+	})) }).nullable(),
+	createdAt: z.string()
+});
+const hitchMessageSchema = z.object({
+	id: z.uuid(),
+	numberId: z.uuid(),
+	direction: z.enum(["inbound", "outbound"]),
+	status: z.enum([
+		"pending",
+		"unknown",
+		"accepted",
+		"sent",
+		"delivered",
+		"unconfirmed",
+		"failed",
+		"received"
+	]),
+	from: z.string(),
+	to: z.string(),
+	body: z.string().nullable(),
+	redacted: z.boolean(),
+	userId: z.uuid().nullable(),
+	appletId: z.uuid().nullable(),
+	requestId: z.string().nullable(),
+	errorCode: z.string().nullable(),
+	errorDetail: z.string().nullable(),
+	statusAt: z.string().nullable(),
+	createdAt: z.string()
+});
+const listHitchNumbersOutputSchema = z.object({ data: z.array(hitchPhoneNumberSchema) });
+const listHitchMessagesOutputSchema = z.object({
+	data: z.array(hitchMessageSchema),
+	nextCursor: z.string().nullable()
+});
+const listHitchCallsOutputSchema = z.object({
+	data: z.array(hitchCallSchema),
+	nextCursor: z.string().nullable()
 });
-const membershipSchema = z.object({
-	orgId: z.uuid(),
-	code: z.string(),
-	name: z.string(),
-	iconFileId: z.uuid().nullable(),
-	role: z.enum(["member", "owner"]),
-	capabilities: z.array(z.string())
+const idInputSchema = z.object({ id: z.uuid() });
+const listInputFields = {
+	numberId: z.uuid().optional(),
+	userId: z.uuid().optional(),
+	direction: z.enum(["inbound", "outbound"]).optional(),
+	since: z.iso.datetime().optional(),
+	until: z.iso.datetime().optional(),
+	cursor: z.string().optional(),
+	limit: z.number().int().min(1).max(200).optional()
+};
+const listHitchMessagesInputSchema = z.object(listInputFields);
+const listHitchCallsInputSchema = z.object({
+	...listInputFields,
+	status: z.enum([
+		"starting",
+		"ringing",
+		"active",
+		"ended",
+		"missed",
+		"failed"
+	]).optional()
 });
-const meSchema = z.object({
-	person: personSchema,
-	memberships: z.array(membershipSchema),
-	organization: z.object({
-		id: z.uuid(),
-		code: z.string()
-	}).nullable(),
-	multiOrg: z.boolean()
+const sendHitchMessageInputSchema = z.object({
+	numberId: z.uuid(),
+	to: z.string(),
+	body: z.string().min(1).max(1600),
+	requestId: z.string().min(1).max(200).optional()
 });
-const meContract = { get: oc.route({
-	method: "GET",
-	path: "/v1/me"
-}).input(z.void()).output(meSchema) };
+const telephonyContract = {
+	calls: {
+		get: oc.route({
+			method: "GET",
+			path: "/v1/telephony/calls/{id}"
+		}).input(idInputSchema).output(hitchCallSchema),
+		list: oc.route({
+			method: "GET",
+			path: "/v1/telephony/calls"
+		}).input(listHitchCallsInputSchema).output(listHitchCallsOutputSchema)
+	},
+	numbers: { list: oc.route({
+		method: "GET",
+		path: "/v1/telephony/numbers"
+	}).input(z.void()).output(listHitchNumbersOutputSchema) },
+	messages: {
+		get: oc.route({
+			method: "GET",
+			path: "/v1/telephony/messages/{id}"
+		}).input(idInputSchema).output(hitchMessageSchema),
+		list: oc.route({
+			method: "GET",
+			path: "/v1/telephony/messages"
+		}).input(listHitchMessagesInputSchema).output(listHitchMessagesOutputSchema),
+		send: oc.route({
+			method: "POST",
+			path: "/v1/telephony/messages",
+			successStatus: 201
+		}).input(sendHitchMessageInputSchema).output(hitchMessageSchema)
+	}
+};
 //#endregion
 //#region src/hitch/teams.ts
 const teamSchema = z.object({
@@ -133,4 +248,4 @@ const teamsContract = {
 	}).input(teamIdInputSchema).output(teamMembersOutputSchema) }
 };
 //#endregion
-export { appletDefinitionSchema, appletManifestSchema, appletSourceDefinitionSchema, createFileOutputSchema, fileSchema, filesContract, getFileOutputSchema, meContract, meSchema, pruneContract, registerHitchContract, teamMemberSchema, teamSchema, teamsContract, uploadFile };
+export { appletDefinitionSchema, appletManifestSchema, appletSourceDefinitionSchema, createEmailPixelInputSchema, createEmailPixelOutputSchema, createFileOutputSchema, emailContract, emailTagKeySchema, emailTagsSchema, emailTrackerSchema, fileSchema, filesContract, getEmailTrackerInputSchema, getFileOutputSchema, hitchMessageSchema, hitchPhoneNumberSchema, listEmailTrackersInputSchema, listEmailTrackersOutputSchema, listHitchMessagesInputSchema, listHitchMessagesOutputSchema, listHitchNumbersOutputSchema, markEmailTrackerSentInputSchema, meContract, meSchema, pruneContract, registerHitchContract, sendHitchMessageInputSchema, teamMemberSchema, teamSchema, teamsContract, telephonyContract, uploadFile };

package/dist/{init-CQRsnd3i.js → init-tfzwuYnk.js}

@@ -1,8 +1,8 @@
-import { a as ORG_CODE_PATTERN, i as APPLET_CODE_PATTERN } from "./manifest-DyoJ1MIL.js";
-import { i as resolveInstanceUrl, r as resolveAuthForOrg } from "./auth-DaVK0k5R.js";
-import { n as runGenerate } from "./generate-BFmIzHaR.js";
-import { n as loadAppletSourceDefinition, r as readWorkspaceConfig } from "./load-config-BnxocLAQ.js";
-import { a as writeWorkspaceSupport, i as writeAppletSupport, n as loadCliManifest, t as assertWorkspaceCli } from "./project-CEmDnlKa.js";
+import { a as ORG_CODE_PATTERN, i as APPLET_CODE_PATTERN } from "./manifest-Bp87Uz0a.js";
+import { d as resolveInstanceUrl, i as readWorkspaceConfig, u as resolveAuthForOrg } from "./workspace-XVtM12ZC.js";
+import { n as runGenerate } from "./generate-CBPnHoqX.js";
+import { n as loadAppletSourceDefinition } from "./load-config-BYSxDVAl.js";
+import { a as writeAppletSupport, n as loadCliManifest, o as writeWorkspaceSupport, t as assertWorkspaceCli } from "./project-D6XHllmC.js";
 import { access, cp, mkdir, readdir, writeFile } from "node:fs/promises";
 import { relative, resolve } from "node:path";
 import { spawn } from "node:child_process";
@@ -23,8 +23,11 @@ async function assertTargetIsAvailable(paths, targetType) {
 	if (existingPath !== void 0) throw new Error(`Refusing to initialize ${targetType}: ${existingPath} already exists.`);
 }
 async function assertDirectoryIsEmpty(path) {
-	const [entry] = await readdir(path);
-	if (entry !== void 0) throw new Error(`Refusing to initialize a workspace: ${path} is not empty (${entry} exists).`);
+	const entries = await readdir(path);
+	if (entries.length > 0) {
+		const [entry] = entries;
+		throw new Error(`Refusing to initialize a workspace: ${path} is not empty (${entry} exists).`);
+	}
 }
 async function installDependencies(target, install) {
 	if (!install) return "skipped";
@@ -33,7 +36,8 @@ async function installDependencies(target, install) {
 		let finished = false;
 		const child = spawn("pnpm", ["install"], {
 			cwd: target,
-			stdio: "inherit"
+			stdio: "inherit",
+			shell: process.platform === "win32"
 		});
 		child.once("error", (error) => {
 			finished = true;

package/dist/load-config-BYSxDVAl.js

@@ -0,0 +1,27 @@
+import { r as appletSourceDefinitionSchema } from "./manifest-Bp87Uz0a.js";
+import { t as resolveWorkspaceOrg } from "./workspace-XVtM12ZC.js";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { loadConfigFromFile } from "vite";
+//#region src/typegen/load-config.ts
+async function loadAppletSourceDefinition(root) {
+	const path = resolve(root, "applet.manifest.ts");
+	if (!existsSync(path)) throw new Error(`No applet manifest found at ${path}.`);
+	const loaded = await loadConfigFromFile({
+		command: "build",
+		mode: "production"
+	}, path, root);
+	if (loaded === null) throw new Error(`No applet manifest found at ${path}.`);
+	const parsed = appletSourceDefinitionSchema.safeParse(loaded.config);
+	if (!parsed.success) throw new Error(`Invalid applet manifest at ${loaded.path}: ${parsed.error.message}`);
+	return parsed.data;
+}
+async function loadAppletConfig(root) {
+	const { dependencies: _dependencies, devDependencies: _devDependencies, ...definition } = await loadAppletSourceDefinition(root);
+	return {
+		org: resolveWorkspaceOrg(root),
+		...definition
+	};
+}
+//#endregion
+export { loadAppletSourceDefinition as n, loadAppletConfig as t };

package/dist/login-C7RKmmTe.js

@@ -0,0 +1,12 @@
+import { a as loginWithDevice, d as resolveInstanceUrl, o as AuthenticationError, r as findWorkspaceConfig } from "./workspace-XVtM12ZC.js";
+//#region src/login.ts
+async function runLogin(options) {
+	if (process.env.HITCH_API_KEY !== void 0) throw new AuthenticationError("HITCH_API_KEY is set — unset it to manage stored logins.");
+	const { me, membership } = await loginWithDevice(await resolveInstanceUrl(), {
+		expectedOrg: findWorkspaceConfig(process.cwd())?.org,
+		noBrowser: options.noBrowser
+	});
+	console.log(`Signed in as ${me.person.email} to ${membership.name}.`);
+}
+//#endregion
+export { runLogin };

package/dist/{logs-m00pzr_O.js → logs-DgjgAxj2.js}

@@ -1,6 +1,6 @@
-import { i as APPLET_CODE_PATTERN } from "./manifest-DyoJ1MIL.js";
-import { t as fetchWithOrgAuth } from "./auth-DaVK0k5R.js";
-import { i as resolveWorkspaceOrg, r as readWorkspaceConfig, t as loadAppletConfig } from "./load-config-BnxocLAQ.js";
+import { i as APPLET_CODE_PATTERN } from "./manifest-Bp87Uz0a.js";
+import { i as readWorkspaceConfig, n as fetchWithOrgAuth, t as resolveWorkspaceOrg } from "./workspace-XVtM12ZC.js";
+import { t as loadAppletConfig } from "./load-config-BYSxDVAl.js";
 import { z } from "zod";
 //#region src/logs.ts
 const LOG_LEVELS = [

package/dist/{manifest-DyoJ1MIL.js → manifest-Bp87Uz0a.js}

@@ -63,6 +63,8 @@ const appletManifestShape = {
 	org: z.string().regex(ORG_CODE_PATTERN, "must start with a lowercase letter, end with a letter or number, and contain only lowercase letters, numbers, and non-consecutive hyphens"),
 	name: nameSchema,
 	code: codeSchema,
+	requiresChangeset: z.uuid().optional(),
+	telephony: z.strictObject({ events: z.array(z.literal("message.received")).min(1).refine((events) => new Set(events).size === events.length).readonly() }).optional(),
 	schedules: appletManifestSchedulesSchema.optional(),
 	variables: appletManifestVariablesSchema.optional(),
 	objects: appletManifestObjectsSchema
@@ -94,6 +96,8 @@ const appletManifestSchema = z.strictObject(appletManifestShape).superRefine(che
 const appletDefinitionSchema = z.strictObject({
 	name: appletManifestShape.name,
 	code: appletManifestShape.code,
+	requiresChangeset: appletManifestShape.requiresChangeset,
+	telephony: appletManifestShape.telephony,
 	schedules: appletManifestShape.schedules,
 	variables: appletManifestShape.variables,
 	objects: appletManifestShape.objects
@@ -161,6 +165,8 @@ const checkSourcePackages = (manifest, context) => {
 const appletSourceDefinitionSchema = z.strictObject({
 	name: appletManifestShape.name,
 	code: appletManifestShape.code,
+	requiresChangeset: appletManifestShape.requiresChangeset,
+	telephony: appletManifestShape.telephony,
 	schedules: appletManifestShape.schedules,
 	variables: appletManifestShape.variables,
 	objects: appletManifestShape.objects,

package/dist/{manifest-BQCAxATS.d.ts → manifest-DD_SGkS6.d.ts}

@@ -32,6 +32,11 @@ interface AppletManifest {
   org: string;
   name: string;
   code: string;
+  /** This code needs the schema as of this changeset. */
+  requiresChangeset?: string;
+  telephony?: {
+    events: readonly "message.received"[];
+  };
   schedules?: readonly {
     code: string;
     name: string;

package/dist/me-BW7Paary.js

@@ -0,0 +1,32 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+//#region src/hitch/me.ts
+const personSchema = z.object({
+	id: z.uuid(),
+	firstName: z.string(),
+	lastName: z.string(),
+	email: z.email()
+});
+const membershipSchema = z.object({
+	orgId: z.uuid(),
+	code: z.string(),
+	name: z.string(),
+	iconFileId: z.uuid().nullable(),
+	role: z.enum(["member", "owner"]),
+	capabilities: z.array(z.string())
+});
+const meSchema = z.object({
+	person: personSchema,
+	memberships: z.array(membershipSchema),
+	organization: z.object({
+		id: z.uuid(),
+		code: z.string()
+	}).nullable(),
+	multiOrg: z.boolean()
+});
+const meContract = { get: oc.route({
+	method: "GET",
+	path: "/v1/me"
+}).input(z.void()).output(meSchema) };
+//#endregion
+export { meSchema as n, meContract as t };

package/dist/{project-CEmDnlKa.js → project-D6XHllmC.js}

@@ -1,4 +1,5 @@
-import { n as loadAppletSourceDefinition, r as readWorkspaceConfig } from "./load-config-BnxocLAQ.js";
+import { i as readWorkspaceConfig } from "./workspace-XVtM12ZC.js";
+import { n as loadAppletSourceDefinition } from "./load-config-BYSxDVAl.js";
 import { z } from "zod";
 import { existsSync } from "node:fs";
 import { cp, mkdir, readFile, rm, symlink, writeFile } from "node:fs/promises";
@@ -50,11 +51,11 @@ const cliManifestSchema = z.object({
 async function loadCliManifest(options) {
 	const result = cliManifestSchema.safeParse(JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")));
 	if (!result.success) {
-		const issue = result.error.issues[0];
+		const issue = result.error.issues.at(0);
 		if (issue === void 0) throw new Error("Invalid CLI package manifest.");
 		throw new Error(`Invalid CLI package manifest field "${issue.path.join(".")}": ${issue.message}.`);
 	}
-	const catalogEntry = [...Object.entries(result.data.dependencies).map(([name, value]) => [`dependencies.${name}`, value]), ...Object.entries(result.data.peerDependencies).map(([name, value]) => [`peerDependencies.${name}`, value])].find(([, value]) => value?.startsWith("catalog:"));
+	const catalogEntry = [...Object.entries(result.data.dependencies).map(([name, value]) => [`dependencies.${name}`, value]), ...Object.entries(result.data.peerDependencies).map(([name, value]) => [`peerDependencies.${name}`, value])].find(([, value]) => value.startsWith("catalog:"));
 	if (catalogEntry !== void 0) {
 		if (options?.allowDevelopment === true) return void 0;
 		throw new Error(`Invalid CLI package manifest field "${catalogEntry[0]}": "catalog:" identifies an unpublished development build. Run the published @hitch42/applet CLI instead.`);
@@ -127,8 +128,14 @@ minimumReleaseAgeExclude:
 }
 const GITIGNORE_START = "# BEGIN Hitch generated files";
 const GITIGNORE_END = "# END Hitch generated files";
+const SKILLS = [
+	"hitch-applets",
+	"hitch-cli",
+	"hitch-data",
+	"hitch-theory"
+];
 const GITIGNORE = `${GITIGNORE_START}
-/.agents/skills/hitch-applets/
+${SKILLS.map((skill) => `/.agents/skills/${skill}/`).join("\n")}
 /.node-version
 /AGENTS.md
 /CLAUDE.md
@@ -169,16 +176,21 @@ async function writeWorkspaceSupport(root, config, cli) {
 	const resolvedCli = cli ?? await loadCliManifest();
 	if (resolvedCli === void 0) throw new Error("The CLI package manifest is not published.");
 	assertWorkspaceCli(config, resolvedCli);
-	const skillTarget = resolve(root, ".agents/skills/hitch-applets");
+	const deployWorkflowTarget = resolve(root, ".github/workflows/hitch.yml");
 	const agents = await readFile(new URL("../scaffold/AGENTS.md", import.meta.url), "utf8");
-	await Promise.all([mkdir(resolve(root, ".agents/skills"), { recursive: true }), rm(skillTarget, {
-		force: true,
-		recursive: true
-	})]);
 	await Promise.all([
-		cp(new URL("../scaffold/.agents/skills/hitch-applets", import.meta.url), skillTarget, { recursive: true }),
+		mkdir(resolve(root, ".agents/skills"), { recursive: true }),
+		config.githubWorkflow === false ? void 0 : mkdir(resolve(root, ".github/workflows"), { recursive: true }),
+		...SKILLS.map((skill) => rm(resolve(root, ".agents/skills", skill), {
+			force: true,
+			recursive: true
+		}))
+	]);
+	await Promise.all([
+		...SKILLS.map((skill) => cp(new URL(`../scaffold/.agents/skills/${skill}`, import.meta.url), resolve(root, ".agents/skills", skill), { recursive: true })),
 		writeFile(resolve(root, "package.json"), `${JSON.stringify(workspacePackage(config.org), null, 2)}\n`),
 		writeFile(resolve(root, "pnpm-workspace.yaml"), workspaceFile(resolvedCli)),
+		config.githubWorkflow === false || existsSync(deployWorkflowTarget) ? void 0 : cp(new URL("../scaffold/.github/workflows/hitch.yml", import.meta.url), deployWorkflowTarget),
 		writeFile(resolve(root, ".node-version"), "24\n"),
 		writeGitignore(root),
 		writeFile(resolve(root, "AGENTS.md"), agents)
@@ -330,17 +342,17 @@ export default defineConfig({
 		hasClient ? writeFile(resolve(root, "components.json"), await readFile(new URL("../scaffold/applet/components.json", import.meta.url), "utf8")) : void 0
 	]);
 }
-async function prepareAppletProject(appletRoot = process.cwd()) {
-	const definition = await loadAppletSourceDefinition(appletRoot);
-	const workspaceRoot = dirname(dirname(resolve(appletRoot)));
+async function prepareAppletProjects(workspaceRoot, appletRoots) {
+	const definitions = await Promise.all(appletRoots.map((root) => loadAppletSourceDefinition(root)));
 	const workspace = readWorkspaceConfig(workspaceRoot);
-	if (workspace === void 0) throw new Error(`No Hitch workspace found for ${appletRoot}.`);
+	if (workspace === void 0) throw new Error(`No Hitch workspace found at ${workspaceRoot}.`);
 	const cli = await loadCliManifest({ allowDevelopment: true });
-	await Promise.all([cli === void 0 ? void 0 : writeWorkspaceSupport(workspaceRoot, workspace, cli), writeAppletSupport(appletRoot, definition)]);
-	return {
-		definition,
-		workspaceRoot
-	};
+	await Promise.all([cli === void 0 ? void 0 : writeWorkspaceSupport(workspaceRoot, workspace, cli), ...appletRoots.map((root, index) => writeAppletSupport(root, definitions[index]))]);
+}
+async function prepareAppletProject(appletRoot = process.cwd()) {
+	const workspaceRoot = dirname(dirname(resolve(appletRoot)));
+	await prepareAppletProjects(workspaceRoot, [appletRoot]);
+	return workspaceRoot;
 }
 //#endregion
-export { writeWorkspaceSupport as a, writeAppletSupport as i, loadCliManifest as n, prepareAppletProject as r, assertWorkspaceCli as t };
+export { writeAppletSupport as a, prepareAppletProjects as i, loadCliManifest as n, writeWorkspaceSupport as o, prepareAppletProject as r, assertWorkspaceCli as t };

package/dist/prompt-ChS-grYO.js

@@ -0,0 +1,29 @@
+import { Writable } from "node:stream";
+import { createInterface } from "node:readline";
+//#region src/prompt.ts
+function question(prompt, hidden = false) {
+	return new Promise((resolveAnswer, rejectAnswer) => {
+		let muted = false;
+		const output = hidden ? new Writable({ write(chunk, encoding, callback) {
+			if (!muted) process.stdout.write(chunk, encoding);
+			callback();
+		} }) : process.stdout;
+		const readline = createInterface({
+			input: process.stdin,
+			output,
+			terminal: true
+		});
+		readline.once("error", rejectAnswer);
+		if (hidden) {
+			process.stdout.write(prompt);
+			muted = true;
+		}
+		readline.question(hidden ? "" : prompt, (answer) => {
+			readline.close();
+			if (hidden) process.stdout.write("\n");
+			resolveAnswer(answer);
+		});
+	});
+}
+//#endregion
+export { question as t };

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { a as UploadedHitchFile } from "./upload-YbRKEqR6.js";
+import { a as UploadedHitchFile } from "./upload-DKZzz5kW.js";
 import { ReactElement } from "react";
 import "@tiptap/core";
 //#region src/react/markdown.d.ts