deepline 0.3.45 → 0.3.47

package/dist/bundling-sources/shared_libs/play-runtime/tool-result-types.ts

@@ -1,206 +1 @@
-import type { EmailStatusExtractorConfig } from './email-status';
-import type { DeeplineGetterValueMap } from './extractor-targets';
-import type { PlayDataset, SerializedPlayDataset } from '../plays/dataset';
-
-export type ToolResultExecutionMetadata = {
-  idempotent: true;
-  cached: boolean;
-  source: 'live' | 'checkpoint' | 'cache' | 'in_flight';
-  cacheKey?: string;
-  receiptRole?: 'owner' | 'follower';
-  receiptKey?: string;
-  attachedToReceiptKey?: string;
-};
-
-export type ToolResultTargetMetadata = {
-  value: unknown;
-  path: string;
-};
-
-export type ToolResultListMetadata = {
-  path: string;
-  count: number | null;
-  keys: Record<string, string>;
-};
-
-export type ToolResultExtractorDescriptor = {
-  paths: readonly string[];
-  transforms?: readonly string[];
-  enum?: readonly string[];
-  overrides?: readonly ToolResultExtractorOverride[];
-  emailStatus?: EmailStatusExtractorConfig;
-};
-
-export type ToolResultExtractorOverride = {
-  paths: readonly string[];
-  equals?: string | number | boolean | null;
-  value: string | number | boolean | null;
-};
-
-export type ToolResultMetadata = {
-  toolId: string;
-  execution: ToolResultExecutionMetadata;
-  targets: Record<string, ToolResultTargetMetadata>;
-  lists: Record<string, ToolResultListMetadata>;
-  /** Original declarations preserve semantic accessor names across replay. */
-  listExtractorPaths?: readonly string[];
-  extractors?: Record<string, ToolResultExtractorDescriptor>;
-};
-
-export type ToolResultTargetAccessor<T = unknown> = ToolResultTargetMetadata & {
-  get(): T | null;
-};
-
-export type ToolResultListAccessor<
-  T = Record<string, unknown>,
-  TKey extends string = string,
-> = Omit<ToolResultListMetadata, 'keys'> & {
-  keys: Partial<Record<TKey, string>> & Record<string, string>;
-  get(): PlayDataset<T>;
-};
-
-export type ToolResultMetadataInput = {
-  toolId: string;
-  extractors?: Record<string, ToolResultExtractorDescriptor>;
-  targetGetters?: Record<string, readonly string[]>;
-  listExtractorPaths?: readonly string[];
-  listIdentityGetters?: Record<string, readonly string[]>;
-};
-
-export type ToolResultEnvelope<
-  TData = unknown,
-  TMeta = Record<string, unknown>,
-> = {
-  data: TData;
-  meta?: TMeta;
-};
-
-export type SerializedToolExecuteResultV1 = {
-  __kind: 'deepline.tool_execute_result.v1';
-  status: string;
-  job_id?: string;
-  /** Deepline-owned execution/result metadata. */
-  meta?: Record<string, unknown>;
-  toolResponse: {
-    /**
-     * Raw provider/tool data with declared row-list payloads clipped to bounded
-     * previews. Use list getters for row-shaped data.
-     */
-    raw: unknown;
-    meta?: Record<string, unknown>;
-  };
-  listDatasets?: Record<string, SerializedPlayDataset<Record<string, unknown>>>;
-  /** Full declared list rows used to rehydrate list Dataset Handles. */
-  listRows?: Record<string, Array<Record<string, unknown>>>;
-  /** Computed scalar/object getters preserved before raw list previews are clipped. */
-  targetValues?: Record<string, ToolResultTargetMetadata>;
-  metadata: ToolResultMetadataInput;
-  execution: ToolResultExecutionMetadata;
-};
-
-/**
- * Canonical receipt form. Provider data is stored once as `rawV2`; the legacy
- * raw/meta view is recreated from the payload-free projection descriptor.
- */
-export type SerializedToolExecuteResultV2 = Omit<
-  SerializedToolExecuteResultV1,
-  '__kind' | 'toolResponse'
-> & {
-  __kind: 'deepline.tool_execute_result.v2';
-  toolResponse: {
-    rawV2: unknown;
-    view: 'data' | 'rawV2';
-    /** Deepline-owned additions not already represented in `rawV2.meta`. */
-    responseMeta?: Record<string, unknown>;
-  };
-};
-
-export type SerializedToolExecuteResult =
-  | SerializedToolExecuteResultV1
-  | SerializedToolExecuteResultV2;
-
-export type ToolResponseEnvelope<
-  TData = unknown,
-  TMeta = Record<string, unknown>,
-> = {
-  raw: TData;
-  /** Complete parsed and scrubbed provider response, materialized from raw-v2. */
-  rawV2?: unknown;
-  /** Durable descriptor for deriving the legacy raw view from `rawV2`. */
-  view?: 'data' | 'rawV2';
-  meta?: TMeta;
-};
-
-export type ToolExecuteResultBase<
-  TResult = unknown,
-  TMeta = Record<string, unknown>,
-> = {
-  status: string;
-  job_id?: string;
-  /** Deepline-owned execution/result metadata. */
-  meta?: Record<string, unknown>;
-  toolResponse: ToolResponseEnvelope<TResult, TMeta>;
-  extractedValues: Record<string, ToolResultTargetAccessor>;
-  extractedLists: Record<string, ToolResultListAccessor>;
-  /** Convenience alias for play code. Serialized output uses toolResponse. */
-  toolOutput: ToolResponseEnvelope<TResult, TMeta>;
-  _metadata: {
-    toolId: string;
-    execution: ToolResultExecutionMetadata;
-    targets: Record<string, { value: unknown; path: string }>;
-    extractors?: Record<string, ToolResultExtractorDescriptor>;
-    lists: Record<
-      string,
-      {
-        path: string;
-        count: number | null;
-        keys: Record<string, string>;
-      }
-    >;
-    /** Original declarations preserve semantic accessor names across replay. */
-    listExtractorPaths?: readonly string[];
-  };
-};
-
-export type ToolExecuteResultAccessors<
-  TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>,
-  TLists extends Record<string, Record<string, unknown>> = Record<
-    string,
-    Record<string, unknown>
-  >,
-> = {
-  extractedValues: {
-    [K in keyof TExtracted]: ToolResultTargetAccessor<TExtracted[K]>;
-  };
-  extractedLists: {
-    [K in keyof TLists]: ToolResultListAccessor<TLists[K]>;
-  };
-};
-
-/**
- * Canonical result returned by Deepline tool execution.
- *
- * The top-level object is Deepline-owned execution metadata and semantic
- * extraction state. The canonical provider response lives under
- * `toolResponse.rawV2`; `toolResponse.raw` remains the legacy compatibility
- * projection. Response metadata lives under `toolResponse.meta`. Semantic single-value
- * getters live under `extractedValues.<name>.get()`, and list getters live
- * under `extractedLists.<name>.get()`.
- *
- * Use extractors first when a tool contract exposes them. Use list getters for
- * row-shaped data. Drop to `toolResponse.raw` only for provider-specific scalar
- * fields or bounded debugging context; persisted rows may clip declared lists to
- * previews.
- *
- * @sdkReference runtime 200
- */
-export type ToolExecuteResult<
-  TResult = unknown,
-  TMeta = Record<string, unknown>,
-  TExtracted extends Record<string, unknown> = Partial<DeeplineGetterValueMap>,
-  TLists extends Record<string, Record<string, unknown>> = Record<
-    string,
-    Record<string, unknown>
-  >,
-> = ToolExecuteResultBase<TResult, TMeta> &
-  ToolExecuteResultAccessors<TExtracted, TLists>;
+export * from '../plays/tool-result-types';

package/dist/bundling-sources/shared_libs/play-runtime/tool-result.ts

@@ -8,24 +8,24 @@ export type {
   ToolResultListAccessor,
   ToolResultTargetMetadata,
   ToolResultTargetAccessor,
-} from './tool-result-types';
+} from '../plays/tool-result-types';
 export type {
   EmailDeliverability,
   EmailMxClass,
   EmailStatus,
   EmailStatusValue,
   EmailStatusVerdict,
-} from './email-status';
+} from '../plays/email-status';
 
 import {
   buildEmailStatus,
   type EmailStatusExtractorConfig,
-} from './email-status';
+} from '../plays/email-status';
 import {
   JOB_CHANGE_STATUS_VALUES,
   type JobChangeGetterValue,
   type JobChangeStatus,
-} from './extractor-targets';
+} from '../plays/extractor-targets';
 import type {
   SerializedToolExecuteResult,
   ToolExecuteResult,
@@ -37,7 +37,7 @@ import type {
   ToolResultMetadataInput,
   ToolResultTargetAccessor,
   ToolResultTargetMetadata,
-} from './tool-result-types';
+} from '../plays/tool-result-types';
 import {
   createDeferredPlayDataset,
   createPlayDataset,
@@ -47,13 +47,16 @@ import {
   type PlayDataset,
   type SerializedPlayDataset,
 } from '../plays/dataset';
-import { normalizeTableNamespace, sha256Hex } from '../plays/row-identity';
+import {
+  normalizeTableNamespace,
+  sha256Hex,
+} from '../plays/row-identity';
 import { listNameFromDeclaredPath } from './tool-result-paths';
 import {
   legacyRawFromToolResponseRawV2,
   providerMetaFromToolResponseRawV2,
   type ToolResponseView,
-} from './tool-response-contract';
+} from '../plays/tool-response-contract';
 
 type PathSegment = string | number | '*';
 

package/dist/bundling-sources/shared_libs/play-runtime/work-receipts.ts

@@ -1,5 +1,5 @@
 import { isReusableWorkReceiptState } from './work-receipt-state-machine';
-import type { ToolExecutionFailureV1 } from '../tool-execution-error';
+import type { ToolExecutionFailureV1 } from '../plays/tool-execution-error';
 
 export type WorkReceiptFailureKind = 'terminal' | 'repairable';
 

package/dist/bundling-sources/shared_libs/plays/artifact-types.ts

@@ -1,5 +1,5 @@
-import type { ToolExecutionErrorSchemaVersion } from '../tool-execution-error';
-import type { ToolResponseContract } from '../play-runtime/tool-response-contract';
+import type { ToolExecutionErrorSchemaVersion } from './tool-execution-error';
+import type { ToolResponseContract } from './tool-response-contract';
 import type { PlayAuthoringContractEdition } from './authoring-contract';
 
 export type PlayPackageImport = {
@@ -36,7 +36,12 @@ export type PlayArtifactCompatibility = {
 };
 
 /** The only executable Play artifact contract. */
-export type PlayArtifactKind = 'cjs_node20';
+export const PLAY_ARTIFACT_KINDS = {
+  cjsNode20: 'cjs_node20',
+} as const;
+
+export type PlayArtifactKind =
+  (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_KINDS];
 
 export type PlayBundleArtifact = {
   codeFormat: 'cjs_module';

package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts

@@ -1,9 +1,9 @@
 import { Type, type Static, type TSchema } from '@sinclair/typebox';
 import { Value } from '@sinclair/typebox/value';
-import type { PreviousCell } from '../play-runtime/cell-staleness';
-import type { PlaySandboxRuntimeLimits } from '../play-runtime/sandbox-runtime-limits';
-import type { ToolExecuteResult } from '../play-runtime/tool-result-types';
-import type { ToolExecutionErrorSchemaVersion } from '../tool-execution-error';
+import type { PreviousCell } from './cell-staleness';
+import type { PlaySandboxRuntimeLimits } from './sandbox-runtime-limits';
+import type { ToolExecuteResult } from './tool-result-types';
+import type { ToolExecutionErrorSchemaVersion } from './tool-execution-error';
 import type { PlayDataset, PlayDatasetInput, PlayDatasetRow } from './dataset';
 
 export const LEGACY_PLAY_AUTHORING_CONTRACT_EDITION = 1 as const;

package/dist/bundling-sources/shared_libs/plays/bundling/index.ts

@@ -21,10 +21,7 @@ import {
   type Message,
   type Plugin,
 } from 'esbuild';
-import {
-  PLAY_ARTIFACT_KINDS,
-  type PlayArtifactKind,
-} from '../../play-runtime/backend';
+import { PLAY_ARTIFACT_KINDS, type PlayArtifactKind } from '../artifact-types';
 import type { PlayCompilerManifest } from '../compiler-manifest';
 import type {
   PlayArtifactCompatibility,
@@ -56,8 +53,8 @@ export {
   type DocflowBindingResolution,
   type DocflowSymbolResolution,
 } from '../docflow-binding';
-import type { ToolExecutionErrorSchemaVersion } from '../../tool-execution-error';
-import type { PlaySandboxRuntimeDeclaration } from '../../play-runtime/sandbox-runtime-limits';
+import type { ToolExecutionErrorSchemaVersion } from '../tool-execution-error';
+import type { PlaySandboxRuntimeDeclaration } from '../sandbox-runtime-limits';
 import { validatePlaySourceFilesHaveNoInlineSecrets } from '../secret-guardrails';
 import { MAX_PLAY_BUNDLE_BYTES } from './limits';
 import { PLAY_AUTHORING_CONTRACT_EDITION } from '../authoring-contract';

package/dist/bundling-sources/shared_libs/plays/cell-staleness.ts

@@ -0,0 +1,66 @@
+/** Stored per-cell freshness and completion metadata. */
+export type CellStalenessMeta = {
+  status?: string | null;
+  completedAt?: number | null;
+  staleAt?: number | null;
+  staleAfterSeconds?: number | null;
+};
+
+/**
+ * Previous durable cell value passed to object-column resolvers.
+ *
+ * The runtime supplies this when a row+column is being recomputed after a
+ * previous value existed. `value` has the same type that the column returns;
+ * freshness metadata lives beside it.
+ *
+ * @sdkReference runtime 120
+ */
+export type PreviousCell<Value = unknown> = {
+  /** Previous completed value for this row+column. */
+  value: Value;
+  /** Millisecond timestamp when the previous value completed. */
+  completedAt?: number;
+  /** Millisecond timestamp when the previous value becomes stale; `null` means no expiry. */
+  staleAt?: number | null;
+  /** Resolved numeric TTL in seconds for the previous value, when present. */
+  staleAfterSeconds?: number;
+};
+
+export const DEEPLINE_CELL_META_FIELD = '__deeplineCellMeta';
+
+export function previousCellFromValue<Value>(input: {
+  hasValue: boolean;
+  value: Value;
+  meta?: CellStalenessMeta | null;
+}): PreviousCell<Value> | undefined {
+  if (!input.hasValue) {
+    return undefined;
+  }
+
+  const previous: PreviousCell<Value> = {
+    value: input.value,
+  };
+  if (
+    typeof input.meta?.completedAt === 'number' &&
+    Number.isFinite(input.meta.completedAt)
+  ) {
+    previous.completedAt = input.meta.completedAt;
+  }
+  if (
+    input.meta &&
+    Object.prototype.hasOwnProperty.call(input.meta, 'staleAt')
+  ) {
+    previous.staleAt =
+      typeof input.meta.staleAt === 'number' &&
+      Number.isFinite(input.meta.staleAt)
+        ? input.meta.staleAt
+        : null;
+  }
+  if (
+    typeof input.meta?.staleAfterSeconds === 'number' &&
+    Number.isFinite(input.meta.staleAfterSeconds)
+  ) {
+    previous.staleAfterSeconds = input.meta.staleAfterSeconds;
+  }
+  return previous;
+}

package/dist/bundling-sources/shared_libs/plays/compiler-manifest.ts

@@ -1,4 +1,4 @@
-import type { PlayArtifactKind } from '../play-runtime/backend';
+import type { PlayArtifactKind } from './artifact-types';
 import type { PlayStaticPipeline } from './static-pipeline';
 import type { AdmittedPlayAuthoringContract } from './authoring-contract';
 

package/dist/bundling-sources/shared_libs/plays/contracts.ts

@@ -2,7 +2,7 @@ import {
   SUPPORTED_TOOL_EXECUTION_ERROR_SCHEMA_VERSIONS,
   TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
   type ToolExecutionErrorSchemaVersion,
-} from '../tool-execution-error';
+} from './tool-execution-error';
 import { CURRENT_PLAY_ARTIFACT_CONTRACT_VERSION } from './artifact-contract-version';
 import {
   PLAY_AUTHORING_CONTRACT_EDITION,
@@ -18,7 +18,7 @@ import {
   RAW_V2_TOOL_RESPONSE_RECEIPT_REVISION,
   UnsupportedToolResponseContractError,
   type ToolResponseContract,
-} from '../play-runtime/tool-response-contract';
+} from './tool-response-contract';
 
 export type PlayContractSource = 'ad_hoc' | 'draft' | 'published';