terse-types 0.5.2 → 0.6.0

package/README.md

@@ -9,7 +9,7 @@ Internal shared types for the [Terse](https://useterse.ai) platform.
 If you landed here while building a workflow, you almost certainly want one of these instead:
 
 - **[`terse-cli`](https://www.npmjs.com/package/terse-cli)** to scaffold, test, and deploy workflows
-- **[`terse-sdk`](https://www.npmjs.com/package/terse-sdk)** to write workflow code (`createJob`, `generateText`, trigger types)
+- **[`terse-sdk`](https://www.npmjs.com/package/terse-sdk)** to write workflow code (`createJob`, `step`, `waitForInput`, trigger types)
 - **[docs.useterse.ai](https://docs.useterse.ai)** for guides and reference
 
 If a doc, post, or LLM pointed you at `terse-types` directly, that was probably a mistake on our end. [Let us know](mailto:support@useterse.ai) so we can fix it. The types you actually need are re-exported from `terse-sdk`.

package/dist/ActorEndpoint.d.ts

@@ -0,0 +1,9 @@
+export interface ActorEndpoint {
+    kind: "terse" | "runtime";
+    origin: string;
+    projectId: string;
+    actorUrl: string;
+    contractUrl: string;
+}
+/** The URL selects the API explicitly; localhost alone never changes authentication or routing. */
+export declare function parseActorEndpoint(value: string): ActorEndpoint;

package/dist/ActorEndpoint.js

@@ -0,0 +1,32 @@
+/** The URL selects the API explicitly; localhost alone never changes authentication or routing. */
+export function parseActorEndpoint(value) {
+    const invalid = () => new Error("TERSE_ACTOR_URL must be an HTTP(S) URL ending in /<projectId>/actors or /v1/projects/<projectId>/actors, without credentials, query, or fragment");
+    let url;
+    try {
+        url = new URL(value.trim());
+    }
+    catch {
+        throw invalid();
+    }
+    const match = /^\/(?:(sdk|v1)\/projects\/)?([^/]+)\/actors\/?$/.exec(url.pathname);
+    if (!match || !["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash)
+        throw invalid();
+    let projectId;
+    try {
+        projectId = decodeURIComponent(match[2]);
+    }
+    catch {
+        throw invalid();
+    }
+    if (!/^[A-Za-z0-9._-]{1,64}$/.test(projectId) || projectId === "." || projectId === "..")
+        throw invalid();
+    const kind = match[1] === "v1" ? "runtime" : "terse";
+    const project = encodeURIComponent(projectId);
+    return {
+        kind,
+        origin: url.origin,
+        projectId,
+        actorUrl: `${url.origin}${kind === "runtime" ? `/v1/projects/${project}` : `/${project}`}/actors`,
+        contractUrl: `${url.origin}${kind === "runtime" ? `/v1/projects/${project}/deployment/contract` : `/sdk/projects/${project}/actors/contract`}`
+    };
+}

package/dist/ApiRouteBuilder.d.ts

@@ -194,6 +194,9 @@ export declare const ApiRoutes: {
         INPUT_REQUEST: string;
         INPUT_RESPONSE: string;
         CREATE_PROJECT: string;
+        ACTOR_CONTRACT: string;
+        ACTOR_CONNECT: string;
+        ACTOR_INVOKE: string;
         DEPLOY: string;
         IDENTIFY: string;
         DEVICE_TOKEN_EXCHANGE: string;

package/dist/ApiRoutes.json

@@ -194,6 +194,9 @@
         "INPUT_REQUEST": "/sdk/input-request",
         "INPUT_RESPONSE": "/sdk/input-request/:token/response",
         "CREATE_PROJECT": "/sdk/projects",
+        "ACTOR_CONTRACT": "/sdk/projects/:projectId/actors/contract",
+        "ACTOR_CONNECT": "/:projectId/actors",
+        "ACTOR_INVOKE": "/:projectId/actors/invoke",
         "DEPLOY": "/sdk/deploy",
         "IDENTIFY": "/sdk/auth/identify",
         "DEVICE_TOKEN_EXCHANGE": "/sdk/auth/device-token-exchange",

package/dist/types.d.ts

@@ -15463,6 +15463,8 @@ export declare const sdkDeployRequestBodySchema: z.ZodObject<{
             campaignIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>]>>;
     }, z.core.$strip>>;
+    actorTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    actorContract: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
     remoteServerUrl: z.ZodOptional<z.ZodString>;
     sourceZipBase64: z.ZodOptional<z.ZodString>;
     sourceObjectKey: z.ZodOptional<z.ZodString>;
@@ -15495,6 +15497,7 @@ export declare const sdkDeployRemovedSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const sdkDeployResponseBodySchema: z.ZodObject<{
     success: z.ZodBoolean;
+    actorTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     signingSecret: z.ZodOptional<z.ZodString>;
     projectApiKey: z.ZodOptional<z.ZodString>;
     results: z.ZodArray<z.ZodObject<{

package/dist/types.js

@@ -697,6 +697,9 @@ export const sdkDeployRequestBodySchema = z
     projectId: z.string(),
     cliVersion: z.string(),
     jobs: z.array(sdkDeployJobSchema),
+    actorTypes: z.array(z.string().min(1)).optional(),
+    /** Public actor API compiled by little-actors; validated by the control plane on registration. */
+    actorContract: z.record(z.string(), z.json()).optional(),
     remoteServerUrl: z.string().optional(),
     sourceZipBase64: z.string().optional(),
     /** Key of an archive already uploaded to object storage. Preferred over sourceZipBase64. */
@@ -743,6 +746,7 @@ export const sdkDeployRemovedSchema = z.object({
 });
 export const sdkDeployResponseBodySchema = z.object({
     success: z.boolean(),
+    actorTypes: z.array(z.string()).optional(),
     signingSecret: z.string().optional(),
     projectApiKey: z.string().optional(),
     results: z.array(sdkDeployResultSchema),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-types",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "type": "module",
   "description": "Shared Terse TypeScript types, enums, constants, and helpers.",
   "main": "./dist/index.js",