Class: ToolResultForLog¶

Persisted tool-result shape written by the live tool-result logger and read back by the replay subsystem. Closes audit §3.1 row 4. Slot names match services/session-state/src/log/types.ts:97 verbatim so existing log fixtures under the session-state fixtures directories continue to deserialise unchanged (FR-011).

URI: debrief:class/ToolResultForLog

 classDiagram
    class ToolResultForLog
    click ToolResultForLog href "../../classes/ToolResultForLog/"
      ToolResultForLog : artifact_href

      ToolResultForLog : duration_ms

      ToolResultForLog : features





        ToolResultForLog --> "0..1" Any : features
        click Any href "../../classes/Any/"



      ToolResultForLog : input_state





        ToolResultForLog --> "*" Any : input_state
        click Any href "../../classes/Any/"



      ToolResultForLog : result_type

      ToolResultForLog : source_feature_ids

      ToolResultForLog : success

      ToolResultForLog : tool_id

Slots¶

Name	Cardinality and Range	Description	Inheritance
success	1 Boolean	Whether the tool succeeded	direct
features	0..1 Any	GeoJSON FeatureCollection produced by the tool	direct
duration_ms	1 Integer	Wall-clock duration of the tool invocation in milliseconds	direct
result_type	0..1 String	Hierarchical result type (e	direct
source_feature_ids	* String	IDs of input features used to generate this result	direct
artifact_href	0..1 String	Path to an exported artifact (for non-GeoJSON tool results)	direct
tool_id	0..1 String	Tool identifier (mirrors LogEntry	direct
input_state	* Any	Pre-tool geometry snapshot for mutation tools — passed through to LogEntry	direct

Identifier and Mapping Information¶

Schema Source¶

from schema: https://debrief.info/schemas/debrief

Mappings¶

Mapping Type	Mapped Value
self	debrief:ToolResultForLog
native	debrief:ToolResultForLog

LinkML Source¶

Direct¶

name: ToolResultForLog
description: Persisted tool-result shape written by the live tool-result logger and
  read back by the replay subsystem. Closes audit §3.1 row 4. Slot names match `services/session-state/src/log/types.ts:97`
  verbatim so existing log fixtures under the session-state fixtures directories continue
  to deserialise unchanged (FR-011).
from_schema: https://debrief.info/schemas/debrief
attributes:
  success:
    name: success
    description: Whether the tool succeeded.
    from_schema: https://debrief.info/schemas/mcp
    domain_of:
    - ToolResult
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: boolean
    required: true
  features:
    name: features
    description: GeoJSON FeatureCollection produced by the tool. Free-form per Article
      XV.2 (the tool's output shape is its own contract).
    from_schema: https://debrief.info/schemas/mcp
    domain_of:
    - RawGeoJSONFeatureCollection
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: Any
  duration_ms:
    name: duration_ms
    description: Wall-clock duration of the tool invocation in milliseconds.
    from_schema: https://debrief.info/schemas/mcp
    domain_of:
    - MCPToolResponse
    - MCPErrorResponse
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: integer
    required: true
  result_type:
    name: result_type
    description: Hierarchical result type (e.g. mutation/track/smoothed).
    from_schema: https://debrief.info/schemas/mcp
    rank: 1000
    domain_of:
    - ToolResultForLog
    range: string
  source_feature_ids:
    name: source_feature_ids
    description: IDs of input features used to generate this result.
    from_schema: https://debrief.info/schemas/mcp
    domain_of:
    - LastToolExecution
    - ToolResultForLog
    range: string
    multivalued: true
  artifact_href:
    name: artifact_href
    description: Path to an exported artifact (for non-GeoJSON tool results).
    from_schema: https://debrief.info/schemas/mcp
    rank: 1000
    domain_of:
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: string
  tool_id:
    name: tool_id
    description: Tool identifier (mirrors LogEntry.was_generated_by.tool).
    from_schema: https://debrief.info/schemas/mcp
    domain_of:
    - StacAsset
    - LastToolExecution
    - ToolResultForLog
    range: string
  input_state:
    name: input_state
    description: 'Pre-tool geometry snapshot for mutation tools — passed through to
      LogEntry. Free-form per Article XV.2 (the inner InputFeatureState shape is owned
      by #224 session-state).'
    from_schema: https://debrief.info/schemas/mcp
    domain_of:
    - LogEntry
    - ToolResultForLog
    range: Any
    multivalued: true

Induced¶

name: ToolResultForLog
description: Persisted tool-result shape written by the live tool-result logger and
  read back by the replay subsystem. Closes audit §3.1 row 4. Slot names match `services/session-state/src/log/types.ts:97`
  verbatim so existing log fixtures under the session-state fixtures directories continue
  to deserialise unchanged (FR-011).
from_schema: https://debrief.info/schemas/debrief
attributes:
  success:
    name: success
    description: Whether the tool succeeded.
    from_schema: https://debrief.info/schemas/mcp
    alias: success
    owner: ToolResultForLog
    domain_of:
    - ToolResult
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: boolean
    required: true
  features:
    name: features
    description: GeoJSON FeatureCollection produced by the tool. Free-form per Article
      XV.2 (the tool's output shape is its own contract).
    from_schema: https://debrief.info/schemas/mcp
    alias: features
    owner: ToolResultForLog
    domain_of:
    - RawGeoJSONFeatureCollection
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: Any
  duration_ms:
    name: duration_ms
    description: Wall-clock duration of the tool invocation in milliseconds.
    from_schema: https://debrief.info/schemas/mcp
    alias: duration_ms
    owner: ToolResultForLog
    domain_of:
    - MCPToolResponse
    - MCPErrorResponse
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: integer
    required: true
  result_type:
    name: result_type
    description: Hierarchical result type (e.g. mutation/track/smoothed).
    from_schema: https://debrief.info/schemas/mcp
    rank: 1000
    alias: result_type
    owner: ToolResultForLog
    domain_of:
    - ToolResultForLog
    range: string
  source_feature_ids:
    name: source_feature_ids
    description: IDs of input features used to generate this result.
    from_schema: https://debrief.info/schemas/mcp
    alias: source_feature_ids
    owner: ToolResultForLog
    domain_of:
    - LastToolExecution
    - ToolResultForLog
    range: string
    multivalued: true
  artifact_href:
    name: artifact_href
    description: Path to an exported artifact (for non-GeoJSON tool results).
    from_schema: https://debrief.info/schemas/mcp
    rank: 1000
    alias: artifact_href
    owner: ToolResultForLog
    domain_of:
    - ToolResultForLog
    - ToolExecutionResultForReplay
    range: string
  tool_id:
    name: tool_id
    description: Tool identifier (mirrors LogEntry.was_generated_by.tool).
    from_schema: https://debrief.info/schemas/mcp
    alias: tool_id
    owner: ToolResultForLog
    domain_of:
    - StacAsset
    - LastToolExecution
    - ToolResultForLog
    range: string
  input_state:
    name: input_state
    description: 'Pre-tool geometry snapshot for mutation tools — passed through to
      LogEntry. Free-form per Article XV.2 (the inner InputFeatureState shape is owned
      by #224 session-state).'
    from_schema: https://debrief.info/schemas/mcp
    alias: input_state
    owner: ToolResultForLog
    domain_of:
    - LogEntry
    - ToolResultForLog
    range: Any
    multivalued: true