@ai-matrx/alchemy 0.13.0 → 0.15.0

package/dist/operate.d.cts

@@ -1,48 +1,11 @@
+import { Payload, Json as Json$2, Column, ContentTransferError } from '@ai-matrx/kit/transfer-json';
+export { Column, ContentTransferError, Json, NormalizeTransferJsonOptions, Payload, normalizeTransferJson } from '@ai-matrx/kit/transfer-json';
+
 /**
  * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
+ * Moved in ALC-16; `Json`/`Payload`/`Column` now live in `@ai-matrx/kit/transfer-json`; the format-adapter contract lives in `./contract`.
  */
-type Json$2 = null | boolean | number | string | Json$2[] | {
-    [key: string]: Json$2;
-};
-type Payload = 
-/** A text payload may name its language (code blocks): downloads take its extension, Markdown fences it. */
-{
-    kind: "text";
-    text: string;
-    language?: string;
-} | {
-    kind: "markdown";
-    text: string;
-} | {
-    kind: "json";
-    value: Json$2;
-} | {
-    kind: "rows";
-    rows: Record<string, Json$2>[];
-    columns: Column[];
-} | {
-    kind: "registered";
-    format: string;
-    value: Json$2;
-};
-type Column = {
-    id: string;
-    label: string;
-    path: string;
-    visible: boolean;
-    exportable?: boolean;
-    classification?: "ordinary" | "secret" | "credential";
-    /** Declared field shape suitable for a projected table-schema export. */
-    schema?: {
-        dataType?: string;
-        order?: number;
-        required?: boolean;
-        defaultValue?: Json$2;
-        validation?: Json$2;
-        metadata?: Json$2;
-    };
-};
+
 type ExportProjection = {
     rules: {
         target: "payload" | "row";
@@ -315,17 +278,6 @@ declare function assembleAgentPayload(input: AgentPayloadInput, environment?: Ag
     bodyOffset: number;
 };
 
-declare class ContentTransferError extends Error {
-    readonly code: string;
-    readonly path: string | undefined;
-    constructor(code: string, message: string, path?: string);
-    /**
-     * One error class across every loaded copy: while `@ai-matrx/kit/content-transfer`
-     * still bundles this module for its not-yet-repointed consumers (ALC-16), an
-     * error raised by one copy is `instanceof` the other.
-     */
-    static [Symbol.hasInstance](value: unknown): boolean;
-}
 /** A realm-wide brand (Symbol.for), so a binding made by one loaded copy is recognised by another. */
 declare const bound: unique symbol;
 type BoundAllMatching = {
@@ -335,10 +287,6 @@ type BoundAllMatching = {
     readonly columns: readonly Column[];
     readonly limits?: TransferLimits;
 };
-type NormalizeTransferJsonOptions = {
-    omitUndefinedObjectProperties?: boolean;
-};
-declare function normalizeTransferJson(value: unknown, options?: NormalizeTransferJsonOptions): Json$2;
 /** Column ids are identities, never an alternative data address. */
 declare function readTransferCell(row: Record<string, Json$2>, column: Column): Json$2 | undefined;
 declare function projectSnapshot(raw: RawSnapshot, projection: ExportProjection): Snapshot;
@@ -571,6 +519,8 @@ interface SurfaceDeclaration {
     configNamespaces?: readonly ConfigNamespaceDeclaration[];
     evidenceSources?: readonly EvidenceSourceDeclaration[];
     skipBaselineValues?: boolean;
+    /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
+    skipBaselineItemTypes?: boolean;
 }
 type ValueProvenance = {
     kind: "own";
@@ -1347,6 +1297,22 @@ interface Delivery {
     send(artifact: SealedArtifact, to: WriteTargetRef, via: "destination"): Promise<Receipt>;
 }
 
+/**
+ * Reasoning ("thinking") blocks in model output. A copy of an answer leaves them out by default;
+ * the menu's "Copy including thinking" variant puts them back (`stripThinking` prop of
+ * `MatrxCopyMenu`). Pure and tiny: no engine is loaded.
+ *
+ * Same contract as print's `removeThinkingContent` — `thinking.test.ts` runs both over one corpus
+ * so the two cannot drift apart.
+ */
+/** Does this content carry any reasoning block? */
+declare function hasThinking(text: string): boolean;
+/**
+ * The content without its reasoning blocks. A block between blank lines (its own paragraph) leaves two
+ * paragraphs; a block inside a paragraph collapses to one line break; three or more newlines collapse to two.
+ */
+declare function stripThinking(text: string): string;
+
 /**
  * Operate formats — one adapter per format, stable ids, synchronous eligibility, lazy engines
  * (Matrx Alchemy CONTRACT §1.9 / §2.3, ALC-16).
@@ -1591,4 +1557,4 @@ declare function setPersonDefaultRecipe(ports: Pick<AlchemyHostPorts, "persisten
     [key: string]: Json;
 } | null): Promise<void>;
 
-export { type AgentPayloadEnvironment, type AgentPayloadInput, type AiPreparation, type Artifact, type BoundAllMatching, type BuiltInFormatId, type CannotApply, type CapturedAllMatching, type CapturedSource, type Column, ContentTransferError, type Coverage, type Delivery, type DeliveryOutcome, type Draft, DuplicateWriteHandlerError, EMPTY_STRUCTURE, type ExportPage, type ExportProjection, FORMAT_ADAPTERS, type FormatAdapter, type FormatEngine, type FormatOptions, type Json$2 as Json, type NodeLimit, type NormalizeTransferJsonOptions, type Notice, type Omission, type OutputSpan, type PageAction, type Payload, type PreparationOptions, type PreparationSession, type QuerySnapshot, type RawSnapshot, type Receipt, type RecipeOrigin, type ResolvedRecipe, type SealedArtifact, type Section, type SectionLayout, type ServerOperation, type Snapshot, type Source, type SpanMap, type StructureRecipe, type SurfaceHandle, TRANSFER_DEFAULT_RECIPE_SETTING, type TransferLimits, type TransferOperation, type TransferOutcome, type TransferPreferenceOverrides, type TransferPreferences, type TransferScope, type TransferSurfaceDeclaration, type TransferTarget, type Transform, type Transport, type WriteApplyRequest, type WriteCaller, type WriteDoor, type WriteDoorDeclarations, type WriteDoorPorts, type WriteHandler, type WriteHandlerResult, type WriteOp, type WriteRefusalReason, type WriteRequest, type WriteReviewPort, type WriteTargetRef, agentPayloadWithSpans, applyJsonStructure, applySectionSelection, applySectionStructure, applyStructureToJson, applyTransferLimits, assembleAgentPayload, buildAgentPayload, capture, collectAllMatching, concretePointers, createBrowserTransport, createDelivery, createDraft, createSurfaceTransferHandle, createWriteDoor, deriveDraft, directSource, displayPath, editDraft, eligibleFormats, exportedColumns, extensionForLanguage, fenceJsonBlock, formatAdapter, isProseSection, isSealed, joinPointer, jsonSize, jsonTextSpans, nodeChars, normalizeTransferJson, offsetSpans, openPreparation, outputPointer, patternBelow, patternCovers, patternMatches, pointerSegments, projectSnapshot, readTransferCell, recipeKey, reduceJson, refreshDraft, resetDraft, resolveDefaultRecipe, resolveTransferPreferences, resolveTransferRegistry, sealArtifact, sealDraft, sealTransferArtifact, sectionLayout, serialize, setPersonDefaultRecipe, sourceChanged, spanMap, stubText, transformRows, undoDraft };
+export { type AgentPayloadEnvironment, type AgentPayloadInput, type AiPreparation, type Artifact, type BoundAllMatching, type BuiltInFormatId, type CannotApply, type CapturedAllMatching, type CapturedSource, type Coverage, type Delivery, type DeliveryOutcome, type Draft, DuplicateWriteHandlerError, EMPTY_STRUCTURE, type ExportPage, type ExportProjection, FORMAT_ADAPTERS, type FormatAdapter, type FormatEngine, type FormatOptions, type NodeLimit, type Notice, type Omission, type OutputSpan, type PageAction, type PreparationOptions, type PreparationSession, type QuerySnapshot, type RawSnapshot, type Receipt, type RecipeOrigin, type ResolvedRecipe, type SealedArtifact, type Section, type SectionLayout, type ServerOperation, type Snapshot, type Source, type SpanMap, type StructureRecipe, type SurfaceHandle, TRANSFER_DEFAULT_RECIPE_SETTING, type TransferLimits, type TransferOperation, type TransferOutcome, type TransferPreferenceOverrides, type TransferPreferences, type TransferScope, type TransferSurfaceDeclaration, type TransferTarget, type Transform, type Transport, type WriteApplyRequest, type WriteCaller, type WriteDoor, type WriteDoorDeclarations, type WriteDoorPorts, type WriteHandler, type WriteHandlerResult, type WriteOp, type WriteRefusalReason, type WriteRequest, type WriteReviewPort, type WriteTargetRef, agentPayloadWithSpans, applyJsonStructure, applySectionSelection, applySectionStructure, applyStructureToJson, applyTransferLimits, assembleAgentPayload, buildAgentPayload, capture, collectAllMatching, concretePointers, createBrowserTransport, createDelivery, createDraft, createSurfaceTransferHandle, createWriteDoor, deriveDraft, directSource, displayPath, editDraft, eligibleFormats, exportedColumns, extensionForLanguage, fenceJsonBlock, formatAdapter, hasThinking, isProseSection, isSealed, joinPointer, jsonSize, jsonTextSpans, nodeChars, offsetSpans, openPreparation, outputPointer, patternBelow, patternCovers, patternMatches, pointerSegments, projectSnapshot, readTransferCell, recipeKey, reduceJson, refreshDraft, resetDraft, resolveDefaultRecipe, resolveTransferPreferences, resolveTransferRegistry, sealArtifact, sealDraft, sealTransferArtifact, sectionLayout, serialize, setPersonDefaultRecipe, sourceChanged, spanMap, stripThinking, stubText, transformRows, undoDraft };

package/dist/operate.d.ts

@@ -1,48 +1,11 @@
+import { Payload, Json as Json$2, Column, ContentTransferError } from '@ai-matrx/kit/transfer-json';
+export { Column, ContentTransferError, Json, NormalizeTransferJsonOptions, Payload, normalizeTransferJson } from '@ai-matrx/kit/transfer-json';
+
 /**
  * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
+ * Moved in ALC-16; `Json`/`Payload`/`Column` now live in `@ai-matrx/kit/transfer-json`; the format-adapter contract lives in `./contract`.
  */
-type Json$2 = null | boolean | number | string | Json$2[] | {
-    [key: string]: Json$2;
-};
-type Payload = 
-/** A text payload may name its language (code blocks): downloads take its extension, Markdown fences it. */
-{
-    kind: "text";
-    text: string;
-    language?: string;
-} | {
-    kind: "markdown";
-    text: string;
-} | {
-    kind: "json";
-    value: Json$2;
-} | {
-    kind: "rows";
-    rows: Record<string, Json$2>[];
-    columns: Column[];
-} | {
-    kind: "registered";
-    format: string;
-    value: Json$2;
-};
-type Column = {
-    id: string;
-    label: string;
-    path: string;
-    visible: boolean;
-    exportable?: boolean;
-    classification?: "ordinary" | "secret" | "credential";
-    /** Declared field shape suitable for a projected table-schema export. */
-    schema?: {
-        dataType?: string;
-        order?: number;
-        required?: boolean;
-        defaultValue?: Json$2;
-        validation?: Json$2;
-        metadata?: Json$2;
-    };
-};
+
 type ExportProjection = {
     rules: {
         target: "payload" | "row";
@@ -315,17 +278,6 @@ declare function assembleAgentPayload(input: AgentPayloadInput, environment?: Ag
     bodyOffset: number;
 };
 
-declare class ContentTransferError extends Error {
-    readonly code: string;
-    readonly path: string | undefined;
-    constructor(code: string, message: string, path?: string);
-    /**
-     * One error class across every loaded copy: while `@ai-matrx/kit/content-transfer`
-     * still bundles this module for its not-yet-repointed consumers (ALC-16), an
-     * error raised by one copy is `instanceof` the other.
-     */
-    static [Symbol.hasInstance](value: unknown): boolean;
-}
 /** A realm-wide brand (Symbol.for), so a binding made by one loaded copy is recognised by another. */
 declare const bound: unique symbol;
 type BoundAllMatching = {
@@ -335,10 +287,6 @@ type BoundAllMatching = {
     readonly columns: readonly Column[];
     readonly limits?: TransferLimits;
 };
-type NormalizeTransferJsonOptions = {
-    omitUndefinedObjectProperties?: boolean;
-};
-declare function normalizeTransferJson(value: unknown, options?: NormalizeTransferJsonOptions): Json$2;
 /** Column ids are identities, never an alternative data address. */
 declare function readTransferCell(row: Record<string, Json$2>, column: Column): Json$2 | undefined;
 declare function projectSnapshot(raw: RawSnapshot, projection: ExportProjection): Snapshot;
@@ -571,6 +519,8 @@ interface SurfaceDeclaration {
     configNamespaces?: readonly ConfigNamespaceDeclaration[];
     evidenceSources?: readonly EvidenceSourceDeclaration[];
     skipBaselineValues?: boolean;
+    /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
+    skipBaselineItemTypes?: boolean;
 }
 type ValueProvenance = {
     kind: "own";
@@ -1347,6 +1297,22 @@ interface Delivery {
     send(artifact: SealedArtifact, to: WriteTargetRef, via: "destination"): Promise<Receipt>;
 }
 
+/**
+ * Reasoning ("thinking") blocks in model output. A copy of an answer leaves them out by default;
+ * the menu's "Copy including thinking" variant puts them back (`stripThinking` prop of
+ * `MatrxCopyMenu`). Pure and tiny: no engine is loaded.
+ *
+ * Same contract as print's `removeThinkingContent` — `thinking.test.ts` runs both over one corpus
+ * so the two cannot drift apart.
+ */
+/** Does this content carry any reasoning block? */
+declare function hasThinking(text: string): boolean;
+/**
+ * The content without its reasoning blocks. A block between blank lines (its own paragraph) leaves two
+ * paragraphs; a block inside a paragraph collapses to one line break; three or more newlines collapse to two.
+ */
+declare function stripThinking(text: string): string;
+
 /**
  * Operate formats — one adapter per format, stable ids, synchronous eligibility, lazy engines
  * (Matrx Alchemy CONTRACT §1.9 / §2.3, ALC-16).
@@ -1591,4 +1557,4 @@ declare function setPersonDefaultRecipe(ports: Pick<AlchemyHostPorts, "persisten
     [key: string]: Json;
 } | null): Promise<void>;
 
-export { type AgentPayloadEnvironment, type AgentPayloadInput, type AiPreparation, type Artifact, type BoundAllMatching, type BuiltInFormatId, type CannotApply, type CapturedAllMatching, type CapturedSource, type Column, ContentTransferError, type Coverage, type Delivery, type DeliveryOutcome, type Draft, DuplicateWriteHandlerError, EMPTY_STRUCTURE, type ExportPage, type ExportProjection, FORMAT_ADAPTERS, type FormatAdapter, type FormatEngine, type FormatOptions, type Json$2 as Json, type NodeLimit, type NormalizeTransferJsonOptions, type Notice, type Omission, type OutputSpan, type PageAction, type Payload, type PreparationOptions, type PreparationSession, type QuerySnapshot, type RawSnapshot, type Receipt, type RecipeOrigin, type ResolvedRecipe, type SealedArtifact, type Section, type SectionLayout, type ServerOperation, type Snapshot, type Source, type SpanMap, type StructureRecipe, type SurfaceHandle, TRANSFER_DEFAULT_RECIPE_SETTING, type TransferLimits, type TransferOperation, type TransferOutcome, type TransferPreferenceOverrides, type TransferPreferences, type TransferScope, type TransferSurfaceDeclaration, type TransferTarget, type Transform, type Transport, type WriteApplyRequest, type WriteCaller, type WriteDoor, type WriteDoorDeclarations, type WriteDoorPorts, type WriteHandler, type WriteHandlerResult, type WriteOp, type WriteRefusalReason, type WriteRequest, type WriteReviewPort, type WriteTargetRef, agentPayloadWithSpans, applyJsonStructure, applySectionSelection, applySectionStructure, applyStructureToJson, applyTransferLimits, assembleAgentPayload, buildAgentPayload, capture, collectAllMatching, concretePointers, createBrowserTransport, createDelivery, createDraft, createSurfaceTransferHandle, createWriteDoor, deriveDraft, directSource, displayPath, editDraft, eligibleFormats, exportedColumns, extensionForLanguage, fenceJsonBlock, formatAdapter, isProseSection, isSealed, joinPointer, jsonSize, jsonTextSpans, nodeChars, normalizeTransferJson, offsetSpans, openPreparation, outputPointer, patternBelow, patternCovers, patternMatches, pointerSegments, projectSnapshot, readTransferCell, recipeKey, reduceJson, refreshDraft, resetDraft, resolveDefaultRecipe, resolveTransferPreferences, resolveTransferRegistry, sealArtifact, sealDraft, sealTransferArtifact, sectionLayout, serialize, setPersonDefaultRecipe, sourceChanged, spanMap, stubText, transformRows, undoDraft };
+export { type AgentPayloadEnvironment, type AgentPayloadInput, type AiPreparation, type Artifact, type BoundAllMatching, type BuiltInFormatId, type CannotApply, type CapturedAllMatching, type CapturedSource, type Coverage, type Delivery, type DeliveryOutcome, type Draft, DuplicateWriteHandlerError, EMPTY_STRUCTURE, type ExportPage, type ExportProjection, FORMAT_ADAPTERS, type FormatAdapter, type FormatEngine, type FormatOptions, type NodeLimit, type Notice, type Omission, type OutputSpan, type PageAction, type PreparationOptions, type PreparationSession, type QuerySnapshot, type RawSnapshot, type Receipt, type RecipeOrigin, type ResolvedRecipe, type SealedArtifact, type Section, type SectionLayout, type ServerOperation, type Snapshot, type Source, type SpanMap, type StructureRecipe, type SurfaceHandle, TRANSFER_DEFAULT_RECIPE_SETTING, type TransferLimits, type TransferOperation, type TransferOutcome, type TransferPreferenceOverrides, type TransferPreferences, type TransferScope, type TransferSurfaceDeclaration, type TransferTarget, type Transform, type Transport, type WriteApplyRequest, type WriteCaller, type WriteDoor, type WriteDoorDeclarations, type WriteDoorPorts, type WriteHandler, type WriteHandlerResult, type WriteOp, type WriteRefusalReason, type WriteRequest, type WriteReviewPort, type WriteTargetRef, agentPayloadWithSpans, applyJsonStructure, applySectionSelection, applySectionStructure, applyStructureToJson, applyTransferLimits, assembleAgentPayload, buildAgentPayload, capture, collectAllMatching, concretePointers, createBrowserTransport, createDelivery, createDraft, createSurfaceTransferHandle, createWriteDoor, deriveDraft, directSource, displayPath, editDraft, eligibleFormats, exportedColumns, extensionForLanguage, fenceJsonBlock, formatAdapter, hasThinking, isProseSection, isSealed, joinPointer, jsonSize, jsonTextSpans, nodeChars, offsetSpans, openPreparation, outputPointer, patternBelow, patternCovers, patternMatches, pointerSegments, projectSnapshot, readTransferCell, recipeKey, reduceJson, refreshDraft, resetDraft, resolveDefaultRecipe, resolveTransferPreferences, resolveTransferRegistry, sealArtifact, sealDraft, sealTransferArtifact, sectionLayout, serialize, setPersonDefaultRecipe, sourceChanged, spanMap, stripThinking, stubText, transformRows, undoDraft };