@nimiplatform/sdk 0.5.14

package/dist/world/generate.js

@@ -0,0 +1,144 @@
+import { createNimiError } from '../runtime/errors.js';
+import { ReasonCode } from '../types/index.js';
+function normalizeString(value) {
+    return String(value || '').trim();
+}
+function normalizeStringList(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((item) => normalizeString(item))
+        .filter(Boolean);
+}
+function resolveSourceModalities(input) {
+    const modalities = new Set();
+    if (normalizeString(input.textPrompt) || normalizeString(input.worldSummary)) {
+        modalities.add('text');
+    }
+    switch (input.conditioning?.type) {
+        case 'image':
+            modalities.add('image');
+            break;
+        case 'multi-image':
+            modalities.add('multi-image');
+            break;
+        case 'video':
+            modalities.add('video');
+            break;
+        default:
+            break;
+    }
+    return Array.from(modalities);
+}
+function buildProjectionPromptText(projection) {
+    const lines = [
+        normalizeString(projection.textPrompt),
+        normalizeString(projection.worldSummary)
+            ? `World summary: ${normalizeString(projection.worldSummary)}`
+            : '',
+        normalizeString(projection.spatialSummary)
+            ? `Spatial summary: ${normalizeString(projection.spatialSummary)}`
+            : '',
+        normalizeString(projection.entitySummary)
+            ? `Entity summary: ${normalizeString(projection.entitySummary)}`
+            : '',
+        projection.moodStyleHints?.length
+            ? `Mood/style hints: ${projection.moodStyleHints.join(', ')}`
+            : '',
+        projection.traversalHints?.length
+            ? `Traversal hints: ${projection.traversalHints.join(', ')}`
+            : '',
+        projection.interactionHints?.length
+            ? `Interaction hints: ${projection.interactionHints.join(', ')}`
+            : '',
+    ].filter(Boolean);
+    return lines.join('\n');
+}
+export function buildWorldInputProjection(input) {
+    const projection = {
+        ...(normalizeString(input.worldId) ? { worldId: normalizeString(input.worldId) } : {}),
+        ...(normalizeString(input.displayName) ? { displayName: normalizeString(input.displayName) } : {}),
+        ...(normalizeString(input.textPrompt) ? { textPrompt: normalizeString(input.textPrompt) } : {}),
+        ...(normalizeString(input.worldSummary) ? { worldSummary: normalizeString(input.worldSummary) } : {}),
+        ...(normalizeString(input.spatialSummary) ? { spatialSummary: normalizeString(input.spatialSummary) } : {}),
+        ...(normalizeString(input.entitySummary) ? { entitySummary: normalizeString(input.entitySummary) } : {}),
+        ...(normalizeStringList(input.moodStyleHints).length > 0 ? { moodStyleHints: normalizeStringList(input.moodStyleHints) } : {}),
+        ...(normalizeStringList(input.traversalHints).length > 0 ? { traversalHints: normalizeStringList(input.traversalHints) } : {}),
+        ...(normalizeStringList(input.interactionHints).length > 0 ? { interactionHints: normalizeStringList(input.interactionHints) } : {}),
+        ...(input.conditioning ? { conditioning: input.conditioning } : {}),
+        ...(normalizeStringList(input.tags).length > 0 ? { tags: normalizeStringList(input.tags) } : {}),
+        ...(Number.isFinite(Number(input.seed)) ? { seed: Number(input.seed) } : {}),
+        sourceModalities: resolveSourceModalities(input),
+    };
+    const hasSemanticInput = Boolean(projection.textPrompt
+        || projection.worldSummary
+        || projection.spatialSummary
+        || projection.entitySummary
+        || projection.conditioning);
+    if (!hasSemanticInput) {
+        throw createNimiError({
+            message: 'world.generate requires text/world semantic input or conditioning media',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_world_projection_input',
+            source: 'sdk',
+        });
+    }
+    return projection;
+}
+export function toRuntimeWorldGenerateInput(projection, options) {
+    const model = normalizeString(options.model);
+    if (!model) {
+        throw createNimiError({
+            message: 'world.generate requires model',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_world_model',
+            source: 'sdk',
+        });
+    }
+    const textPrompt = buildProjectionPromptText(projection);
+    if (!textPrompt && !projection.conditioning) {
+        throw createNimiError({
+            message: 'world.generate projection could not produce runtime input',
+            reasonCode: ReasonCode.ACTION_INPUT_INVALID,
+            actionHint: 'provide_projection_fields',
+            source: 'sdk',
+        });
+    }
+    return {
+        model,
+        ...(projection.displayName ? { displayName: projection.displayName } : {}),
+        ...(textPrompt ? { textPrompt } : {}),
+        ...(projection.tags?.length ? { tags: projection.tags } : {}),
+        ...(Number.isFinite(Number(projection.seed)) ? { seed: Number(projection.seed) } : {}),
+        ...(projection.conditioning ? { conditioning: projection.conditioning } : {}),
+        ...(options.subjectUserId ? { subjectUserId: normalizeString(options.subjectUserId) } : {}),
+        ...(options.route ? { route: options.route } : {}),
+        ...(Number.isFinite(Number(options.timeoutMs)) ? { timeoutMs: Number(options.timeoutMs) } : {}),
+        ...(options.connectorId ? { connectorId: normalizeString(options.connectorId) } : {}),
+        ...(options.metadata ? { metadata: options.metadata } : {}),
+        ...(options.idempotencyKey ? { idempotencyKey: normalizeString(options.idempotencyKey) } : {}),
+        ...(options.requestId ? { requestId: normalizeString(options.requestId) } : {}),
+        ...(options.labels ? { labels: options.labels } : {}),
+        ...(options.signal ? { signal: options.signal } : {}),
+    };
+}
+export async function submitWorldGenerate(client, input) {
+    const projection = buildWorldInputProjection(input);
+    const request = toRuntimeWorldGenerateInput(projection, input);
+    const job = await client.runtime.media.jobs.submit({
+        modal: 'world',
+        input: request,
+    });
+    return {
+        projection,
+        request,
+        job,
+    };
+}
+export const generate = {
+    project: buildWorldInputProjection,
+    toRuntimeInput: toRuntimeWorldGenerateInput,
+    submit: submitWorldGenerate,
+};
+//# sourceMappingURL=generate.js.map

package/dist/world/generate.js.map

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

package/dist/world/index.d.ts

@@ -0,0 +1,41 @@
+import type { PlatformClient } from '../platform-client.js';
+import { truth, normalizeWorldTruthAnchor, normalizeWorldTruthListItem, normalizeWorldTruthSummary, normalizeWorldTruthDetail, readWorldTruthList, readWorldTruthAnchor, readWorldTruthSummary, readWorldTruthDetail } from './truth.js';
+import { generate, buildWorldInputProjection, toRuntimeWorldGenerateInput, submitWorldGenerate } from './generate.js';
+import { fixture, normalizeWorldFixturePackage, normalizeWorldInspectVector, normalizeWorldInspectViewPreset, worldFixtureFromResolvedPaths, pickWorldFixturePreviewSpzUrl, resolveWorldFixtureTitle } from './fixture.js';
+import { render, createInspectWorldRenderPlan } from './render.js';
+import { projection, projectWorldRuntimePayload } from './projection.js';
+import { session, createInspectWorldSession } from './session.js';
+export type * from './types.js';
+export { truth, normalizeWorldTruthAnchor, normalizeWorldTruthListItem, normalizeWorldTruthSummary, normalizeWorldTruthDetail, readWorldTruthList, readWorldTruthAnchor, readWorldTruthSummary, readWorldTruthDetail, generate, buildWorldInputProjection, toRuntimeWorldGenerateInput, submitWorldGenerate, fixture, normalizeWorldFixturePackage, normalizeWorldInspectVector, normalizeWorldInspectViewPreset, worldFixtureFromResolvedPaths, pickWorldFixturePreviewSpzUrl, resolveWorldFixtureTitle, render, createInspectWorldRenderPlan, projection, projectWorldRuntimePayload, session, createInspectWorldSession, };
+export declare function createWorldFacade(client: PlatformClient): {
+    truth: {
+        normalize: typeof normalizeWorldTruthSummary;
+        list: (status?: Parameters<typeof readWorldTruthList>[1]) => Promise<import("./types.js").WorldTruthListItem[]>;
+        read: (worldId: string) => Promise<import("./types.js").WorldTruthSummary>;
+        readAnchor: (worldId: string) => Promise<import("./types.js").WorldTruthAnchor>;
+        readList: (status?: Parameters<typeof readWorldTruthList>[1]) => Promise<import("./types.js").WorldTruthListItem[]>;
+        readSummary: (worldId: string) => Promise<import("./types.js").WorldTruthSummary>;
+        readDetail: (worldId: string, recommendedAgentLimit?: number) => Promise<import("./types.js").WorldTruthDetail>;
+    };
+    generate: {
+        project: typeof buildWorldInputProjection;
+        toRuntimeInput: typeof toRuntimeWorldGenerateInput;
+        submit: (input: Parameters<typeof submitWorldGenerate>[1]) => Promise<import("./types.js").WorldGenerateSubmitResult>;
+    };
+    projection: {
+        projectRuntimePayload: (input: Parameters<typeof projectWorldRuntimePayload>[1]) => Promise<import("./types.js").WorldRuntimeProjectionResult>;
+    };
+    fixture: {
+        normalize: typeof normalizeWorldFixturePackage;
+        fromResolvedPaths: typeof worldFixtureFromResolvedPaths;
+        pickPreviewSpzUrl: typeof pickWorldFixturePreviewSpzUrl;
+        title: typeof resolveWorldFixtureTitle;
+    };
+    render: {
+        createInspectPlan: typeof createInspectWorldRenderPlan;
+    };
+    session: {
+        createInspectSession: typeof createInspectWorldSession;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/world/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,KAAK,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,OAAO,EACP,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,MAAM,EACN,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,UAAU,EACV,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAEtB,mBAAmB,YAAY,CAAC;AAEhC,OAAO,EACL,KAAK,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,QAAQ,EACR,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,OAAO,EACP,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,MAAM,EACN,4BAA4B,EAC5B,UAAU,EACV,0BAA0B,EAC1B,OAAO,EACP,yBAAyB,GAC1B,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc;;;wBAKF,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC;wBACxC,MAAM;8BACA,MAAM;4BACR,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC;+BACrC,MAAM;8BACP,MAAM,0BAA0B,MAAM;;;;;wBAM5C,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC;;;uCAI1B,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;EAOpF"}

package/dist/world/index.js

@@ -0,0 +1,32 @@
+import { truth, normalizeWorldTruthAnchor, normalizeWorldTruthListItem, normalizeWorldTruthSummary, normalizeWorldTruthDetail, readWorldTruthList, readWorldTruthAnchor, readWorldTruthSummary, readWorldTruthDetail, } from './truth.js';
+import { generate, buildWorldInputProjection, toRuntimeWorldGenerateInput, submitWorldGenerate, } from './generate.js';
+import { fixture, normalizeWorldFixturePackage, normalizeWorldInspectVector, normalizeWorldInspectViewPreset, worldFixtureFromResolvedPaths, pickWorldFixturePreviewSpzUrl, resolveWorldFixtureTitle, } from './fixture.js';
+import { render, createInspectWorldRenderPlan, } from './render.js';
+import { projection, projectWorldRuntimePayload, } from './projection.js';
+import { session, createInspectWorldSession, } from './session.js';
+export { truth, normalizeWorldTruthAnchor, normalizeWorldTruthListItem, normalizeWorldTruthSummary, normalizeWorldTruthDetail, readWorldTruthList, readWorldTruthAnchor, readWorldTruthSummary, readWorldTruthDetail, generate, buildWorldInputProjection, toRuntimeWorldGenerateInput, submitWorldGenerate, fixture, normalizeWorldFixturePackage, normalizeWorldInspectVector, normalizeWorldInspectViewPreset, worldFixtureFromResolvedPaths, pickWorldFixturePreviewSpzUrl, resolveWorldFixtureTitle, render, createInspectWorldRenderPlan, projection, projectWorldRuntimePayload, session, createInspectWorldSession, };
+export function createWorldFacade(client) {
+    return {
+        truth: {
+            normalize: truth.normalize,
+            list: (status) => readWorldTruthList(client, status),
+            read: (worldId) => readWorldTruthSummary(client, worldId),
+            readAnchor: (worldId) => readWorldTruthAnchor(client, worldId),
+            readList: (status) => readWorldTruthList(client, status),
+            readSummary: (worldId) => readWorldTruthSummary(client, worldId),
+            readDetail: (worldId, recommendedAgentLimit) => readWorldTruthDetail(client, worldId, recommendedAgentLimit),
+        },
+        generate: {
+            project: generate.project,
+            toRuntimeInput: generate.toRuntimeInput,
+            submit: (input) => submitWorldGenerate(client, input),
+        },
+        projection: {
+            projectRuntimePayload: (input) => projectWorldRuntimePayload(client, input),
+        },
+        fixture,
+        render,
+        session,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/world/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/world/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,QAAQ,EACR,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,OAAO,EACP,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,MAAM,EACN,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,UAAU,EACV,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EACP,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,KAAK,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,QAAQ,EACR,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,EACnB,OAAO,EACP,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,EAC/B,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,MAAM,EACN,4BAA4B,EAC5B,UAAU,EACV,0BAA0B,EAC1B,OAAO,EACP,yBAAyB,GAC1B,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,MAAsB;IAEtB,OAAO;QACL,KAAK,EAAE;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,CAAC,MAAiD,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC;YAC/F,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC;YACjE,UAAU,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC;YACtE,QAAQ,EAAE,CAAC,MAAiD,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC;YACnG,WAAW,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC;YACxE,UAAU,EAAE,CAAC,OAAe,EAAE,qBAA8B,EAAE,EAAE,CAC9D,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC;SAC/D;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,MAAM,EAAE,CAAC,KAAgD,EAAE,EAAE,CAC3D,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC;SACrC;QACD,UAAU,EAAE;YACV,qBAAqB,EAAE,CAAC,KAAuD,EAAE,EAAE,CACjF,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC;SAC5C;QACD,OAAO;QACP,MAAM;QACN,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/world/projection.d.ts

@@ -0,0 +1,7 @@
+import type { PlatformClient } from '../platform-client.js';
+import type { WorldRuntimeProjectionRequest, WorldRuntimeProjectionResult } from './types.js';
+export declare function projectWorldRuntimePayload(client: Pick<PlatformClient, 'realm'>, input: WorldRuntimeProjectionRequest): Promise<WorldRuntimeProjectionResult>;
+export declare const projection: {
+    projectRuntimePayload: typeof projectWorldRuntimePayload;
+};
+//# sourceMappingURL=projection.d.ts.map

package/dist/world/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/world/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AA4BpB,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,EACrC,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,4BAA4B,CAAC,CAKvC;AAED,eAAO,MAAM,UAAU;;CAEtB,CAAC"}

package/dist/world/projection.js

@@ -0,0 +1,28 @@
+function toRuntimeProjectionRequest(input) {
+    return {
+        worldId: input.worldId,
+        ...(input.agentId !== undefined ? { agentId: input.agentId } : {}),
+        ...(input.releaseAnchor !== undefined ? { releaseAnchor: input.releaseAnchor } : {}),
+        ...(input.contextEnvelope !== undefined ? { contextEnvelope: input.contextEnvelope } : {}),
+    };
+}
+function toWorldRuntimeProjectionResult(value) {
+    return {
+        worldId: value.worldId,
+        ...(value.agentId !== undefined ? { agentId: value.agentId } : {}),
+        consumerSurface: value.consumerSurface,
+        ...(value.releaseAnchor !== undefined ? { releaseAnchor: value.releaseAnchor } : {}),
+        checksum: value.checksum,
+        selectedInputs: value.selectedInputs,
+        trace: value.trace,
+        payload: value.payload,
+    };
+}
+export async function projectWorldRuntimePayload(client, input) {
+    const response = await client.realm.services.RuntimeProjectionsService.projectRuntimePayload(toRuntimeProjectionRequest(input));
+    return toWorldRuntimeProjectionResult(response);
+}
+export const projection = {
+    projectRuntimePayload: projectWorldRuntimePayload,
+};
+//# sourceMappingURL=projection.js.map

package/dist/world/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/world/projection.ts"],"names":[],"mappings":"AAMA,SAAS,0BAA0B,CACjC,KAAoC;IAEpC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,KAAmC;IAEnC,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAqC,EACrC,KAAoC;IAEpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,yBAAyB,CAAC,qBAAqB,CAC1F,0BAA0B,CAAC,KAAK,CAAC,CAClC,CAAC;IACF,OAAO,8BAA8B,CAAC,QAAwC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,qBAAqB,EAAE,0BAA0B;CAClD,CAAC"}

package/dist/world/render.d.ts

@@ -0,0 +1,6 @@
+import type { WorldFixturePackage, WorldInspectRenderPlan } from './types.js';
+export declare function createInspectWorldRenderPlan(fixture: WorldFixturePackage | null | undefined): WorldInspectRenderPlan | null;
+export declare const render: {
+    createInspectPlan: typeof createInspectWorldRenderPlan;
+};
+//# sourceMappingURL=render.d.ts.map

package/dist/world/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/world/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAO9E,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,SAAS,GAC9C,sBAAsB,GAAG,IAAI,CA6B/B;AAED,eAAO,MAAM,MAAM;;CAElB,CAAC"}

package/dist/world/render.js

@@ -0,0 +1,38 @@
+import { pickWorldFixturePreviewSpzUrl } from './fixture.js';
+function normalizeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+export function createInspectWorldRenderPlan(fixture) {
+    if (!fixture) {
+        return null;
+    }
+    const spzUrl = pickWorldFixturePreviewSpzUrl(fixture);
+    const previewImageLocalPath = normalizeString(fixture.thumbnailLocalPath) || normalizeString(fixture.panoLocalPath);
+    const previewImageUrl = normalizeString(fixture.thumbnailUrl) || normalizeString(fixture.panoUrl);
+    return {
+        mode: 'inspect',
+        ...(normalizeString(fixture.worldId) ? { worldId: normalizeString(fixture.worldId) } : {}),
+        ...(normalizeString(fixture.manifestPath) ? { manifestPath: normalizeString(fixture.manifestPath) } : {}),
+        ...(spzUrl ? { spzUrl } : {}),
+        ...(normalizeString(fixture.spzLocalPath) ? { spzLocalPath: normalizeString(fixture.spzLocalPath) } : {}),
+        ...(previewImageUrl ? { previewImageUrl } : {}),
+        ...(previewImageLocalPath ? { previewImageLocalPath } : {}),
+        ...(fixture.viewerPreset ? { viewerPreset: fixture.viewerPreset } : {}),
+        capabilityRequirements: {
+            requiresSparkDriver: true,
+            requiresSpzAsset: Boolean(spzUrl || normalizeString(fixture.spzLocalPath)),
+            hasLocalFixture: Boolean(normalizeString(fixture.manifestPath)),
+        },
+        fallback: {
+            previewImageAllowed: Boolean(previewImageUrl || previewImageLocalPath),
+            allowLaunchWithoutManifest: false,
+        },
+        initialCameraPolicy: {
+            source: fixture.viewerPreset ? 'fixture_preset' : 'auto',
+        },
+    };
+}
+export const render = {
+    createInspectPlan: createInspectWorldRenderPlan,
+};
+//# sourceMappingURL=render.js.map

package/dist/world/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/world/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA+C;IAE/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,qBAAqB,GAAG,eAAe,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACpH,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClG,OAAO;QACL,IAAI,EAAE,SAAS;QACf,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzG,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,sBAAsB,EAAE;YACtB,mBAAmB,EAAE,IAAI;YACzB,gBAAgB,EAAE,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC1E,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;SAChE;QACD,QAAQ,EAAE;YACR,mBAAmB,EAAE,OAAO,CAAC,eAAe,IAAI,qBAAqB,CAAC;YACtE,0BAA0B,EAAE,KAAK;SAClC;QACD,mBAAmB,EAAE;YACnB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM;SACzD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,iBAAiB,EAAE,4BAA4B;CAChD,CAAC"}

package/dist/world/session.d.ts

@@ -0,0 +1,15 @@
+import type { WorldFixturePackage, WorldInspectRenderPlan, WorldInspectSession } from './types.js';
+export declare function createInspectWorldSession(input: {
+    fixture?: WorldFixturePackage | null;
+    renderPlan?: WorldInspectRenderPlan | null;
+    attachments?: {
+        activityId?: string;
+        chatId?: string;
+        agentId?: string;
+    };
+    sessionId?: string;
+}): WorldInspectSession;
+export declare const session: {
+    createInspectSession: typeof createInspectWorldSession;
+};
+//# sourceMappingURL=session.d.ts.map

package/dist/world/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/world/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAwBpB,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,UAAU,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,mBAAmB,CAyBtB;AAED,eAAO,MAAM,OAAO;;CAEnB,CAAC"}

package/dist/world/session.js

@@ -0,0 +1,48 @@
+import { nowIso } from '../internal/utils.js';
+function normalizeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function buildSessionId(fixture, renderPlan) {
+    const worldId = normalizeString(fixture?.worldId) || normalizeString(renderPlan?.worldId);
+    const manifestPath = normalizeString(fixture?.manifestPath) || normalizeString(renderPlan?.manifestPath);
+    if (worldId && manifestPath) {
+        return `inspect:${worldId}:${manifestPath}`;
+    }
+    if (worldId) {
+        return `inspect:${worldId}`;
+    }
+    if (manifestPath) {
+        return `inspect:${manifestPath}`;
+    }
+    return 'inspect:ephemeral';
+}
+export function createInspectWorldSession(input) {
+    const fixture = input.fixture || null;
+    const renderPlan = input.renderPlan || null;
+    const sessionId = normalizeString(input.sessionId) || buildSessionId(fixture, renderPlan);
+    const timestamp = nowIso();
+    const lifecycle = renderPlan?.capabilityRequirements.requiresSpzAsset
+        && (renderPlan.spzUrl || renderPlan.spzLocalPath)
+        ? 'ready'
+        : 'degraded';
+    return {
+        sessionId,
+        mode: 'inspect',
+        worldId: normalizeString(fixture?.worldId) || normalizeString(renderPlan?.worldId) || undefined,
+        manifestPath: normalizeString(fixture?.manifestPath) || normalizeString(renderPlan?.manifestPath) || undefined,
+        fixture,
+        renderPlan,
+        attachments: {
+            ...(normalizeString(input.attachments?.activityId) ? { activityId: normalizeString(input.attachments?.activityId) } : {}),
+            ...(normalizeString(input.attachments?.chatId) ? { chatId: normalizeString(input.attachments?.chatId) } : {}),
+            ...(normalizeString(input.attachments?.agentId) ? { agentId: normalizeString(input.attachments?.agentId) } : {}),
+        },
+        lifecycle,
+        createdAt: timestamp,
+        updatedAt: timestamp,
+    };
+}
+export const session = {
+    createInspectSession: createInspectWorldSession,
+};
+//# sourceMappingURL=session.js.map

package/dist/world/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/world/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAO9C,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,cAAc,CACrB,OAA+C,EAC/C,UAAqD;IAErD,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1F,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACzG,IAAI,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,OAAO,WAAW,OAAO,IAAI,YAAY,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,WAAW,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,WAAW,YAAY,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KASzC;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC;IAC5C,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC1F,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,UAAU,EAAE,sBAAsB,CAAC,gBAAgB;WAChE,CAAC,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC;QACjD,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,UAAU,CAAC;IACf,OAAO;QACL,SAAS;QACT,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,SAAS;QAC/F,YAAY,EAAE,eAAe,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,SAAS;QAC9G,OAAO;QACP,UAAU;QACV,WAAW,EAAE;YACX,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzH,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7G,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjH;QACD,SAAS;QACT,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,oBAAoB,EAAE,yBAAyB;CAChD,CAAC"}

package/dist/world/truth.d.ts

@@ -0,0 +1,24 @@
+import type { PlatformClient } from '../platform-client.js';
+import type { WorldTruthAnchor, WorldTruthListItem, WorldTruthDetail, WorldTruthSummary } from './types.js';
+export declare function normalizeWorldTruthAnchor(value: unknown): WorldTruthAnchor | null;
+export declare function normalizeWorldTruthSummary(value: unknown): WorldTruthSummary | null;
+export declare function normalizeWorldTruthListItem(value: unknown): WorldTruthListItem | null;
+export declare function normalizeWorldTruthDetail(value: unknown): WorldTruthDetail | null;
+export declare function readWorldTruthAnchor(client: Pick<PlatformClient, 'domains'>, worldId: string): Promise<WorldTruthAnchor>;
+export declare function readWorldTruthSummary(client: Pick<PlatformClient, 'domains'>, worldId: string): Promise<WorldTruthSummary>;
+export declare function readWorldTruthDetail(client: Pick<PlatformClient, 'domains'>, worldId: string, recommendedAgentLimit?: number): Promise<WorldTruthDetail>;
+export declare function readWorldTruthList(client: Pick<PlatformClient, 'domains'>, status?: WorldTruthSummary['status']): Promise<WorldTruthListItem[]>;
+export declare const truth: {
+    normalize: typeof normalizeWorldTruthSummary;
+    normalizeAnchor: typeof normalizeWorldTruthAnchor;
+    normalizeListItem: typeof normalizeWorldTruthListItem;
+    normalizeSummary: typeof normalizeWorldTruthSummary;
+    normalizeDetail: typeof normalizeWorldTruthDetail;
+    list: typeof readWorldTruthList;
+    read: typeof readWorldTruthSummary;
+    readAnchor: typeof readWorldTruthAnchor;
+    readList: typeof readWorldTruthList;
+    readSummary: typeof readWorldTruthSummary;
+    readDetail: typeof readWorldTruthDetail;
+};
+//# sourceMappingURL=truth.d.ts.map

package/dist/world/truth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truth.d.ts","sourceRoot":"","sources":["../../src/world/truth.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,gBAAgB,EAEhB,kBAAkB,EAElB,gBAAgB,EAEhB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAqPpB,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,IAAI,CAmBzB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,iBAAiB,GAAG,IAAI,CAsB1B;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,IAAI,CAqC3B;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,IAAI,CAqCzB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAe5B;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,qBAAqB,SAAI,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GACnC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAQ/B;AAED,eAAO,MAAM,KAAK;;;;;;;;;;;;CAYjB,CAAC"}