@vibesdotdev/applets 0.0.0-stage → 1.0.0-rc.2

package/dist/client/contract.d.ts

@@ -0,0 +1,113 @@
+import type * as schemas from '../schemas/index.ts';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+import { type RuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+export interface AppletsOwnerScope {
+    ownerType: 'user' | 'organization' | 'system';
+    ownerId: string;
+    viewerUserId?: string;
+    viewerOrgId?: string;
+}
+export declare const appletsClientDescriptor: RuntimeClientDescriptor;
+/**
+ * Runtime client contract for the applets domain. Apps resolve this via
+ * `runtime.query()` and never import sibling packages' internals.
+ */
+export interface AppletsClient extends RuntimeClient {
+    /**
+     * Bind a fresh client to one authenticated request. Server surfaces must
+     * never mutate or reuse the runtime client's owner scope.
+     */
+    forRequest: (scope: AppletsOwnerScope) => AppletsClient;
+    instances: {
+        list: (query?: {
+            ownerId?: string;
+            status?: schemas.AppletInstanceStatus;
+        }) => Promise<schemas.AppletInstance[]>;
+        get: (id: string) => Promise<schemas.AppletInstance | null>;
+        create: (input: {
+            release: schemas.ComponentReleaseRef;
+            title: string;
+            description?: string;
+            visibility?: 'private' | 'org' | 'public';
+            templateRevisionId?: string;
+            /**
+             * What this release declares — owned storage, capability requests, and
+             * contributions. Build it with `buildAppletDefinitionManifest`.
+             *
+             * Optional because instances predate it, but an instance created
+             * without one can never register a contribution or prompt for consent:
+             * there is nothing for the host to read.
+             */
+            definitionManifest?: schemas.AppletDefinitionManifest;
+        }) => Promise<schemas.AppletInstance>;
+        update: (id: string, input: Partial<Pick<schemas.AppletInstance, 'title' | 'description' | 'visibility' | 'status'>>) => Promise<schemas.AppletInstance | null>;
+        delete: (id: string) => Promise<boolean>;
+    };
+    runs: {
+        list: (instanceId: string) => Promise<schemas.AppletRun[]>;
+        start: (instanceId: string) => Promise<schemas.AppletRun>;
+        end: (runId: string) => Promise<void>;
+    };
+    grants: {
+        listAccess: (instanceId: string) => Promise<schemas.AppletAccessGrant[]>;
+        listCapabilities: (instanceId: string) => Promise<schemas.AppletCapabilityGrant[]>;
+        grantCapabilities: (input: {
+            instanceId: string;
+            release: schemas.ComponentReleaseRef;
+            capabilities: string[];
+            capabilityReasons?: Record<string, string>;
+        }) => Promise<schemas.AppletCapabilityGrant>;
+        revokeCapabilities: (grantId: string) => Promise<void>;
+        issueLease: (runId: string) => Promise<schemas.AppletLaunchLease>;
+        revokeLease: (leaseId: string) => Promise<void>;
+    };
+    state: {
+        getShared: (instanceId: string) => Promise<schemas.AppletStateHead | null>;
+        getViewer: (instanceId: string, viewerUserId: string) => Promise<schemas.AppletStateHead | null>;
+        mutate: (input: {
+            instanceId: string;
+            scope: schemas.AppletStateScope;
+            operationId: string;
+            expectedRevision: number;
+            eventType: string;
+            payload: JsonObject;
+        }) => Promise<{
+            receipt: schemas.AppletMutationReceipt;
+            state: schemas.AppletStateHead;
+        }>;
+    };
+    events: {
+        list: (instanceId: string, options?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<schemas.AppletEvent[]>;
+    };
+    checkpoints: {
+        create: (instanceId: string, reason?: schemas.AppletCheckpoint['reason']) => Promise<schemas.AppletCheckpoint>;
+        get: (id: string) => Promise<schemas.AppletCheckpoint | null>;
+    };
+    lineage: {
+        getAncestors: (instanceId: string) => Promise<schemas.AppletLineageEdge[]>;
+        getDescendants: (instanceId: string) => Promise<schemas.AppletLineageEdge[]>;
+    };
+    retention: {
+        /**
+         * Check whether any applet instance references the given Component release.
+         * Used by Component deletion handlers to refuse deletion while referenced.
+         * Returns the referencing instances (empty = safe to delete).
+         */
+        checkRelease: (componentId: string) => Promise<{
+            referenced: boolean;
+            instanceCount: number;
+        }>;
+    };
+}
+/**
+ * Resolve the applets runtime client from the runtime registry.
+ * Throws if the client kind is not registered.
+ */
+export declare function getVibesAppletsClient(runtime: RuntimeRef): Promise<AppletsClient>;
+export { APPLETS_REPOSITORY_CONTEXT_ID, appletsRepositoryContextDescriptor } from './repository.context.ts';
+export type { AppletsRepositoryOwner, AppletsRepository } from './repository.context.ts';
+//# sourceMappingURL=contract.d.ts.map

package/dist/client/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/client/contract.ts"],"names":[],"mappings":"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"}

package/dist/client/contract.js

@@ -0,0 +1,17 @@
+import { getVibesClient, RuntimeClientDescriptorSchema } from '@vibesdotdev/kernel/client';
+export const appletsClientDescriptor = RuntimeClientDescriptorSchema.parse({
+    id: 'applets',
+    kind: 'runtime/client',
+    name: 'Applets Client',
+    description: 'Canonical owner-scoped client for applet instances, grants, runs, state, events, checkpoints, lineage, and release retention.',
+    enabled: true
+});
+/**
+ * Resolve the applets runtime client from the runtime registry.
+ * Throws if the client kind is not registered.
+ */
+export async function getVibesAppletsClient(runtime) {
+    return getVibesClient(appletsClientDescriptor.id, runtime);
+}
+export { APPLETS_REPOSITORY_CONTEXT_ID, appletsRepositoryContextDescriptor } from "./repository.context.js";
+//# sourceMappingURL=contract.js.map

package/dist/client/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/client/contract.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,cAAc,EACd,6BAA6B,EAG7B,MAAM,4BAA4B,CAAC;AASpC,MAAM,CAAC,MAAM,uBAAuB,GAA4B,6BAA6B,CAAC,KAAK,CAClG;IACC,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,gBAAgB;IACtB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACV,+HAA+H;IAChI,OAAO,EAAE,IAAI;CACb,CACD,CAAC;AAsGF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAmB;IAC9D,OAAO,cAAc,CAAgB,uBAAuB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED,OAAO,EACN,6BAA6B,EAC7B,kCAAkC,EAClC,MAAM,yBAAyB,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,3 @@
+export * from './contract.ts';
+export { RuntimeAppletsClient } from './runtime-client.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export * from "./contract.js";
+export { RuntimeAppletsClient } from "./runtime-client.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/client/repository.context.d.ts

@@ -0,0 +1,113 @@
+import type * as schemas from '../schemas/index.ts';
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+export declare const APPLETS_REPOSITORY_CONTEXT_ID = "applets/repository";
+export interface AppletsRepositoryOwner {
+    ownerType: 'user' | 'organization' | 'system';
+    ownerId: string;
+}
+export interface AppletsRepository {
+    /** Trusted host implementations; never inferred from the author manifest. Missing means no external capabilities. */
+    listSupportedCapabilities?: () => Promise<readonly string[]>;
+    listInstances(owner: AppletsRepositoryOwner): Promise<schemas.AppletInstance[]>;
+    getInstance(owner: AppletsRepositoryOwner, id: string): Promise<schemas.AppletInstance | null>;
+    createInstance(owner: AppletsRepositoryOwner, input: {
+        id: string;
+        release: schemas.ComponentReleaseRef;
+        title: string;
+        description?: string;
+        visibility?: 'private' | 'org' | 'public';
+        templateRevisionId?: string;
+        definitionManifest: schemas.AppletDefinitionManifest | null;
+    }): Promise<schemas.AppletInstance>;
+    updateInstance(owner: AppletsRepositoryOwner, id: string, input: Partial<Pick<schemas.AppletInstance, 'title' | 'description' | 'visibility' | 'status'>>): Promise<schemas.AppletInstance | null>;
+    deleteInstance(owner: AppletsRepositoryOwner, id: string): Promise<boolean>;
+    listRuns(instanceId: string): Promise<schemas.AppletRun[]>;
+    getRun(id: string): Promise<schemas.AppletRun | null>;
+    createRun(input: {
+        id: string;
+        instanceId: string;
+        viewerUserId?: string;
+        viewerOrgId?: string;
+    }): Promise<schemas.AppletRun>;
+    endRun(id: string): Promise<void>;
+    listAccessGrants(instanceId: string): Promise<schemas.AppletAccessGrant[]>;
+    listCapabilityGrants(instanceId: string): Promise<schemas.AppletCapabilityGrant[]>;
+    getCapabilityGrant(id: string): Promise<schemas.AppletCapabilityGrant | null>;
+    createCapabilityGrant(input: {
+        id: string;
+        instanceId: string;
+        release: schemas.ComponentReleaseRef;
+        capabilities: string[];
+        capabilityReasons?: Record<string, string>;
+        viewerUserId?: string;
+        viewerOrgId?: string;
+    }): Promise<schemas.AppletCapabilityGrant>;
+    revokeCapabilityGrant(id: string): Promise<void>;
+    getLaunchLease(id: string): Promise<schemas.AppletLaunchLease | null>;
+    createLaunchLease(input: {
+        id: string;
+        instanceId: string;
+        runId: string;
+        nonce: string;
+        expiresAt: Date;
+    }): Promise<schemas.AppletLaunchLease>;
+    revokeLaunchLease(id: string): Promise<void>;
+    getStateHead(instanceId: string, scope: schemas.AppletStateScope, viewerUserId?: string): Promise<schemas.AppletStateHead | null>;
+    mutateState(input: {
+        instanceId: string;
+        scope: schemas.AppletStateScope;
+        operationId: string;
+        expectedRevision: number;
+        eventType: string;
+        payload: JsonObject;
+        viewerUserId?: string;
+    }): Promise<{
+        receipt: schemas.AppletMutationReceipt;
+        state: schemas.AppletStateHead;
+    }>;
+    listEvents(instanceId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<schemas.AppletEvent[]>;
+    createCheckpoint(input: {
+        id: string;
+        instanceId: string;
+        revision: number;
+        stateSnapshot: JsonObject;
+        reason?: schemas.AppletCheckpoint['reason'];
+    }): Promise<schemas.AppletCheckpoint>;
+    getCheckpoint(id: string): Promise<schemas.AppletCheckpoint | null>;
+    listLineageAncestors(instanceId: string): Promise<schemas.AppletLineageEdge[]>;
+    listLineageDescendants(instanceId: string): Promise<schemas.AppletLineageEdge[]>;
+    countInstancesByComponent(componentId: string): Promise<number>;
+}
+export declare const appletsRepositoryContextDescriptor: {
+    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" | "workspace" | "floor")[];
+        subset?: true | undefined;
+    } | undefined;
+};
+export default appletsRepositoryContextDescriptor;
+//# sourceMappingURL=repository.context.d.ts.map

package/dist/client/repository.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.context.d.ts","sourceRoot":"","sources":["../../src/client/repository.context.ts"],"names":[],"mappings":"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"}

package/dist/client/repository.context.js

@@ -0,0 +1,8 @@
+import { createContextDescriptor } from '@vibesdotdev/kernel/factory/context';
+export const APPLETS_REPOSITORY_CONTEXT_ID = 'applets/repository';
+export const appletsRepositoryContextDescriptor = createContextDescriptor({
+    id: APPLETS_REPOSITORY_CONTEXT_ID,
+    description: 'Host-owned Applets persistence and transaction adapter.'
+});
+export default appletsRepositoryContextDescriptor;
+//# sourceMappingURL=repository.context.js.map

package/dist/client/repository.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.context.js","sourceRoot":"","sources":["../../src/client/repository.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAgFlE,MAAM,CAAC,MAAM,kCAAkC,GAAG,uBAAuB,CAAC;IACzE,EAAE,EAAE,6BAA6B;IACjC,WAAW,EAAE,yDAAyD;CACtE,CAAC,CAAC;AAEH,eAAe,kCAAkC,CAAC"}

package/dist/client/runtime-client.d.ts

@@ -0,0 +1,22 @@
+import type { KindContext, RuntimeRef } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient, type RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+import { type AppletsClient, type AppletsOwnerScope } from './contract.ts';
+export declare class RuntimeAppletsClient extends BaseRuntimeClient implements AppletsClient {
+    private readonly requestScope?;
+    constructor(descriptor?: RuntimeClientDescriptor, context?: KindContext, runtime?: RuntimeRef, requestScope?: AppletsOwnerScope);
+    forRequest(scope: AppletsOwnerScope): AppletsClient;
+    readonly instances: AppletsClient['instances'];
+    readonly runs: AppletsClient['runs'];
+    readonly grants: AppletsClient['grants'];
+    readonly state: AppletsClient['state'];
+    readonly events: AppletsClient['events'];
+    readonly checkpoints: AppletsClient['checkpoints'];
+    readonly lineage: AppletsClient['lineage'];
+    readonly retention: AppletsClient['retention'];
+    private scope;
+    private owner;
+    private repository;
+    private ownedInstance;
+}
+export default RuntimeAppletsClient;
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/client/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../../src/client/runtime-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,EAEN,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,MAAM,eAAe,CAAC;AAoBvB,qBAAa,oBAAqB,SAAQ,iBAAkB,YAAW,aAAa;IACnF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAoB;gBAGjD,UAAU,GAAE,uBAAiD,EAC7D,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,UAAU,EACpB,YAAY,CAAC,EAAE,iBAAiB;IAMjC,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa;IAInD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAgB5C;IAEF,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAiBlC;IAEF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAqEtC;IAEF,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAapC;IAEF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAGtC;IAEF,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAgBhD;IAEF,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAKxC;IAEF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,CAK5C;IAEF,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,KAAK;YAKC,UAAU;YAIV,aAAa;CAG3B;AAED,eAAe,oBAAoB,CAAC"}

package/dist/client/runtime-client.js

@@ -0,0 +1,200 @@
+import { assertSupportedAppletCapabilities } from "../authorization.js";
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import { appletsClientDescriptor } from "./contract.js";
+import { APPLETS_REPOSITORY_CONTEXT_ID } from "./repository.context.js";
+import { appletDefinitionManifestSchema } from "../schemas/index.js";
+function sameRelease(left, right) {
+    return left.componentId === right.componentId
+        && left.version === right.version
+        && left.bundleHash === right.bundleHash
+        && (left.manifestHash ?? null) === (right.manifestHash ?? null);
+}
+function sameCapabilities(left, right) {
+    const normalize = (values) => [...new Set(values)].sort();
+    return JSON.stringify(normalize(left)) === JSON.stringify(normalize(right));
+}
+export class RuntimeAppletsClient extends BaseRuntimeClient {
+    requestScope;
+    constructor(descriptor = appletsClientDescriptor, context, runtime, requestScope) {
+        super(descriptor, context, runtime);
+        this.requestScope = requestScope;
+    }
+    forRequest(scope) {
+        return new RuntimeAppletsClient(this.descriptor, undefined, this.runtime, { ...scope });
+    }
+    instances = {
+        list: async (query) => {
+            const scope = this.scope();
+            if (query?.ownerId && query.ownerId !== scope.ownerId)
+                return [];
+            return (await this.repository()).listInstances(this.owner()).then((instances) => instances.filter((instance) => !query?.status || instance.status === query.status));
+        },
+        get: (id) => this.ownedInstance(id),
+        create: async (input) => (await this.repository()).createInstance(this.owner(), {
+            id: crypto.randomUUID(),
+            ...input,
+            definitionManifest: input.definitionManifest ?? null
+        }),
+        update: async (id, input) => (await this.repository()).updateInstance(this.owner(), id, input),
+        delete: async (id) => (await this.repository()).deleteInstance(this.owner(), id)
+    };
+    runs = {
+        list: async (instanceId) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).listRuns(instanceId) : [],
+        start: async (instanceId) => {
+            if (!(await this.ownedInstance(instanceId)))
+                throw new Error('Applet instance not found');
+            const scope = this.scope();
+            return (await this.repository()).createRun({
+                id: crypto.randomUUID(), instanceId,
+                viewerUserId: scope.viewerUserId, viewerOrgId: scope.viewerOrgId
+            });
+        },
+        end: async (runId) => {
+            const repository = await this.repository();
+            const run = await repository.getRun(runId);
+            if (!run || !(await this.ownedInstance(run.instanceId)))
+                throw new Error('Applet run not found');
+            await repository.endRun(runId);
+        }
+    };
+    grants = {
+        listAccess: async (instanceId) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).listAccessGrants(instanceId) : [],
+        listCapabilities: async (instanceId) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).listCapabilityGrants(instanceId) : [],
+        grantCapabilities: async (input) => {
+            const repository = await this.repository();
+            const instance = await this.ownedInstance(input.instanceId);
+            if (!instance)
+                throw new Error('Applet instance not found');
+            if (!sameRelease(instance.release, input.release)) {
+                throw new Error('Capability grant release does not match the installed applet release.');
+            }
+            const manifest = appletDefinitionManifestSchema.safeParse(instance.definitionManifest);
+            if (!manifest.success)
+                throw new Error('Capability consent requires a valid installed manifest.');
+            const declared = new Set(manifest.data.capabilities.map(({ tag }) => tag));
+            const supported = new Set(await repository.listSupportedCapabilities?.() ?? []);
+            const requested = new Set(input.capabilities);
+            for (const capability of requested) {
+                if (!declared.has(capability))
+                    throw new Error(`Capability ${capability} is not declared.`);
+            }
+            assertSupportedAppletCapabilities([...requested], supported);
+            for (const capability of manifest.data.capabilities) {
+                if (capability.required && !requested.has(capability.tag)) {
+                    throw new Error(`Required capability ${capability.tag} was not approved.`);
+                }
+            }
+            const scope = this.scope();
+            const existing = (await repository.listCapabilityGrants(input.instanceId)).find((grant) => grant.revokedAt === null
+                && (grant.viewerUserId ?? undefined) === scope.viewerUserId
+                && (grant.viewerOrgId ?? undefined) === scope.viewerOrgId
+                && sameRelease(grant.release, input.release)
+                && sameCapabilities(grant.capabilities, input.capabilities));
+            if (existing)
+                return existing;
+            const created = await repository.createCapabilityGrant({
+                id: crypto.randomUUID(), ...input,
+                capabilities: [...new Set(input.capabilities)],
+                viewerUserId: scope.viewerUserId, viewerOrgId: scope.viewerOrgId
+            });
+            await repository.updateInstance(this.owner(), input.instanceId, { status: 'active' });
+            return created;
+        },
+        revokeCapabilities: async (grantId) => {
+            const repository = await this.repository();
+            const grant = await repository.getCapabilityGrant(grantId);
+            if (!grant || !(await this.ownedInstance(grant.instanceId))) {
+                throw new Error('Applet capability grant not found');
+            }
+            await repository.revokeCapabilityGrant(grantId);
+        },
+        issueLease: async (runId) => {
+            const repository = await this.repository();
+            const run = await repository.getRun(runId);
+            if (!run || !(await this.ownedInstance(run.instanceId)))
+                throw new Error('Applet run not found');
+            return repository.createLaunchLease({
+                id: crypto.randomUUID(), instanceId: run.instanceId, runId,
+                nonce: crypto.randomUUID(), expiresAt: new Date(Date.now() + 5 * 60 * 1000)
+            });
+        },
+        revokeLease: async (leaseId) => {
+            const repository = await this.repository();
+            const lease = await repository.getLaunchLease(leaseId);
+            if (!lease || !(await this.ownedInstance(lease.instanceId))) {
+                throw new Error('Applet launch lease not found');
+            }
+            await repository.revokeLaunchLease(leaseId);
+        }
+    };
+    state = {
+        getShared: async (instanceId) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).getStateHead(instanceId, 'shared') : null,
+        getViewer: async (instanceId, viewerUserId) => {
+            const scope = this.scope();
+            if (!scope.viewerUserId || viewerUserId !== scope.viewerUserId)
+                return null;
+            return await this.ownedInstance(instanceId)
+                ? (await this.repository()).getStateHead(instanceId, 'viewer', viewerUserId) : null;
+        },
+        mutate: async (input) => {
+            if (!(await this.ownedInstance(input.instanceId)))
+                throw new Error('Applet instance not found');
+            return (await this.repository()).mutateState({ ...input, viewerUserId: this.scope().viewerUserId });
+        }
+    };
+    events = {
+        list: async (instanceId, options) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).listEvents(instanceId, options) : []
+    };
+    checkpoints = {
+        create: async (instanceId, reason) => {
+            const repository = await this.repository();
+            const instance = await this.ownedInstance(instanceId);
+            if (!instance)
+                throw new Error('Applet instance not found');
+            const state = await repository.getStateHead(instanceId, 'shared');
+            return repository.createCheckpoint({
+                id: crypto.randomUUID(), instanceId,
+                revision: state?.revision ?? instance.stateRevision,
+                stateSnapshot: state?.state ?? {}, reason
+            });
+        },
+        get: async (id) => {
+            const checkpoint = await (await this.repository()).getCheckpoint(id);
+            return checkpoint && await this.ownedInstance(checkpoint.instanceId) ? checkpoint : null;
+        }
+    };
+    lineage = {
+        getAncestors: async (instanceId) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).listLineageAncestors(instanceId) : [],
+        getDescendants: async (instanceId) => await this.ownedInstance(instanceId)
+            ? (await this.repository()).listLineageDescendants(instanceId) : []
+    };
+    retention = {
+        checkRelease: async (componentId) => {
+            const instanceCount = await (await this.repository()).countInstancesByComponent(componentId);
+            return { referenced: instanceCount > 0, instanceCount };
+        }
+    };
+    scope() {
+        if (!this.requestScope)
+            throw new Error('Applets client requires an authenticated per-request owner scope.');
+        return this.requestScope;
+    }
+    owner() {
+        const { ownerType, ownerId } = this.scope();
+        return { ownerType, ownerId };
+    }
+    async repository() {
+        return this.runtime.context(APPLETS_REPOSITORY_CONTEXT_ID);
+    }
+    async ownedInstance(id) {
+        return (await this.repository()).getInstance(this.owner(), id);
+    }
+}
+export default RuntimeAppletsClient;
+//# sourceMappingURL=runtime-client.js.map

package/dist/client/runtime-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.js","sourceRoot":"","sources":["../../src/client/runtime-client.ts"],"names":[],"mappings":"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"}

package/dist/companion-path.d.ts

@@ -0,0 +1,25 @@
+/** Extensions the resolver completes an extensionless specifier with, in order. */
+export declare const APPLET_COMPANION_EXTENSIONS: readonly [".svelte", ".svelte.ts", ".svelte.js", ".ts", ".js", ".mjs", ".css", ".md", ".json", ".html", ".txt", ".svg", ".png", ".jpg", ".jpeg", ".gif", ".webp", ".ico"];
+export type AppletCompanionResolution = {
+    readonly ok: true;
+    readonly path: string;
+} | {
+    readonly ok: false;
+    readonly reason: 'not-relative' | 'escape' | 'unresolved' | 'unsupported';
+};
+/**
+ * Resolve `specifier` against the importing file's directory.
+ *
+ * `files` is the project's file inventory (project-relative POSIX paths). A
+ * resolved path must be one of them and must carry an admitted media type —
+ * anything else is `unresolved` or `unsupported` rather than a disk read
+ * outside the contract. An exact name wins; otherwise each admitted extension
+ * is tried, so `./state.svelte` completes to the rune module `state.svelte.ts`
+ * when there is no component by that name.
+ */
+export declare function resolveAppletCompanion(input: {
+    importer: string;
+    specifier: string;
+    files: readonly string[];
+}): AppletCompanionResolution;
+//# sourceMappingURL=companion-path.d.ts.map

package/dist/companion-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-path.d.ts","sourceRoot":"","sources":["../src/companion-path.ts"],"names":[],"mappings":"AAgBA,mFAAmF;AACnF,eAAO,MAAM,2BAA2B,2KAmB7B,CAAC;AAEZ,MAAM,MAAM,yBAAyB,GAClC;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAA;CAAE,CAAC;AA0BrG;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB,GAAG,yBAAyB,CAe5B"}