@vibesdotdev/runnable 0.0.0-stage → 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @vibesdotdev/runnable
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared runtime kinds, execution clients, telemetry and run projections. See [SPEC.md](SPEC.md) for ownership and contracts.
+
+Compose `@vibesdotdev/runnable/common.plugin` for shared clients and events, `@vibesdotdev/runnable/consumer.plugin` for process supervision, or `@vibesdotdev/runnable/cloud.plugin` for the scope-pure cloud slice. UI components are exported separately from `@vibesdotdev/runnable/svelte`.

package/dist/artifact-data.d.ts

@@ -0,0 +1,8 @@
+import type { RunArtifactWrite } from './schemas/writes.ts';
+type ArtifactData = Pick<RunArtifactWrite, 'mimeType' | 'metadata'> & {
+    data?: RunArtifactWrite['data'] | null;
+};
+/** Older producers wrote base64; new producers declare their encoding. */
+export declare function artifactBlob(artifact: ArtifactData): Blob;
+export {};
+//# sourceMappingURL=artifact-data.d.ts.map

package/dist/artifact-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-data.d.ts","sourceRoot":"","sources":["../src/artifact-data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,UAAU,CAAC,GAAG;IACrE,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAQzD"}

package/dist/artifact-data.js

@@ -0,0 +1,12 @@
+import { ArtifactDataEncodingSchema } from "./schemas/events.js";
+/** Older producers wrote base64; new producers declare their encoding. */
+export function artifactBlob(artifact) {
+    const encoding = ArtifactDataEncodingSchema.default('base64').parse(artifact.metadata?.encoding);
+    const data = artifact.data ?? '';
+    if (encoding === 'utf8')
+        return new Blob([data], { type: artifact.mimeType });
+    const binary = atob(data);
+    const bytes = Uint8Array.from(binary, character => character.charCodeAt(0));
+    return new Blob([bytes], { type: artifact.mimeType });
+}
+//# sourceMappingURL=artifact-data.js.map

package/dist/artifact-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-data.js","sourceRoot":"","sources":["../src/artifact-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAOjE,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,QAAsB;IAClD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjG,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE9E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/change-source.d.ts

@@ -0,0 +1,54 @@
+import * as z from 'zod/v4';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { RunExecutionReference } from './schemas/runs.ts';
+/** Invalidation only. Reads still pass through the selected tracking owner's authorization. */
+export declare const RUNNABLE_CHANGE_SOURCE_CONTEXT_ID = "runnable/change-source";
+export declare const RUNNABLE_CHANGE_EVENT = "runnable.owner.changed";
+export declare const RunnableChangePurposeSchema: z.ZodEnum<{
+    telemetry: "telemetry";
+    catalog: "catalog";
+}>;
+export declare const RunnableChangeNotificationSchema: z.ZodObject<{
+    purpose: z.ZodEnum<{
+        telemetry: "telemetry";
+        catalog: "catalog";
+    }>;
+}, z.core.$strict>;
+export type RunnableChangePurpose = z.infer<typeof RunnableChangePurposeSchema>;
+export declare const runnableChangeSourceDescriptor: {
+    id: string;
+    kind: "context";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    valueKind?: "data" | "service" | undefined;
+    valueSchema?: unknown;
+    config?: {
+        sources: ("literal" | "floor" | "workspace")[];
+        subset?: true | undefined;
+    } | undefined;
+};
+export interface RunnableChangeSource {
+    /** Only a known job-scoped native event supplies a hint; persisted and uncertain changes omit it. */
+    subscribe(changed: (nativeReference?: RunExecutionReference) => void, purpose?: 'catalog' | 'native'): Promise<() => void | Promise<void>>;
+    publish(reference?: RunExecutionReference, purpose?: RunnableChangePurpose): Promise<void>;
+}
+/** Persist first, then invalidate readers through the selected host's existing transport. */
+export declare function notifyRunnableChange(runtime: RuntimeRef, reference?: RunExecutionReference, purpose?: RunnableChangePurpose): Promise<void>;
+export declare function subscribeRunnableChanges(runtime: RuntimeRef, changed: (nativeReference?: RunExecutionReference) => void, purpose?: 'catalog' | 'native'): Promise<() => Promise<void>>;
+//# sourceMappingURL=change-source.d.ts.map

package/dist/change-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.d.ts","sourceRoot":"","sources":["../src/change-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,+FAA+F;AAC/F,eAAO,MAAM,iCAAiC,2BAA2B,CAAC;AAC1E,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,2BAA2B;;;EAAmC,CAAC;AAC5E,eAAO,MAAM,gCAAgC;;;;;kBAA2D,CAAC;AACzG,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGzC,CAAC;AACH,MAAM,WAAW,oBAAoB;IACpC,qGAAqG;IACrG,SAAS,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,qBAAqB,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3I,OAAO,CAAC,SAAS,CAAC,EAAE,qBAAqB,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F;AAED,6FAA6F;AAC7F,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,qBAAqB,EAAE,OAAO,GAAE,qBAAiC,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5J;AAED,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE,qBAAqB,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAc5L"}

package/dist/change-source.js

@@ -0,0 +1,37 @@
+import { createContextDescriptor } from '@vibesdotdev/kernel/factory/context';
+import * as z from 'zod/v4';
+import { resolveRunnableEventBroker } from "./event-broker.js";
+/** Invalidation only. Reads still pass through the selected tracking owner's authorization. */
+export const RUNNABLE_CHANGE_SOURCE_CONTEXT_ID = 'runnable/change-source';
+export const RUNNABLE_CHANGE_EVENT = 'runnable.owner.changed';
+export const RunnableChangePurposeSchema = z.enum(['catalog', 'telemetry']);
+export const RunnableChangeNotificationSchema = z.strictObject({ purpose: RunnableChangePurposeSchema });
+export const runnableChangeSourceDescriptor = createContextDescriptor({
+    id: RUNNABLE_CHANGE_SOURCE_CONTEXT_ID,
+    description: 'Notifications from the existing execution host for persisted Runnable changes.'
+});
+/** Persist first, then invalidate readers through the selected host's existing transport. */
+export async function notifyRunnableChange(runtime, reference, purpose = 'catalog') {
+    const admitted = RunnableChangePurposeSchema.parse(purpose);
+    (await resolveRunnableEventBroker(runtime)).notify(admitted);
+    if (runtime.hasContext(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)) {
+        await (await runtime.context(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)).publish(reference, admitted);
+    }
+}
+export async function subscribeRunnableChanges(runtime, changed, purpose) {
+    const stopLocal = (await resolveRunnableEventBroker(runtime)).subscribe(changed, purpose);
+    try {
+        const stopHost = runtime.hasContext(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)
+            ? await (await runtime.context(RUNNABLE_CHANGE_SOURCE_CONTEXT_ID)).subscribe(changed, purpose)
+            : undefined;
+        return async () => {
+            stopLocal();
+            await stopHost?.();
+        };
+    }
+    catch (cause) {
+        stopLocal();
+        throw cause;
+    }
+}
+//# sourceMappingURL=change-source.js.map

package/dist/change-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-source.js","sourceRoot":"","sources":["../src/change-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAG/D,+FAA+F;AAC/F,MAAM,CAAC,MAAM,iCAAiC,GAAG,wBAAwB,CAAC;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAC9D,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;AAEzG,MAAM,CAAC,MAAM,8BAA8B,GAAG,uBAAuB,CAAC;IACrE,EAAE,EAAE,iCAAiC;IACrC,WAAW,EAAE,gFAAgF;CAC7F,CAAC,CAAC;AAOH,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAmB,EAAE,SAAiC,EAAE,UAAiC,SAAS;IAC5I,MAAM,QAAQ,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAuB,iCAAiC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrH,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAAmB,EAAE,OAA0D,EAAE,OAA8B;IAC7J,MAAM,SAAS,GAAG,CAAC,MAAM,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1F,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,iCAAiC,CAAC;YACrE,CAAC,CAAC,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAuB,iCAAiC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;YACpH,CAAC,CAAC,SAAS,CAAC;QACb,OAAO,KAAK,IAAI,EAAE;YACjB,SAAS,EAAE,CAAC;YACZ,MAAM,QAAQ,EAAE,EAAE,CAAC;QACpB,CAAC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,SAAS,EAAE,CAAC;QACZ,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC"}