naftiko: 1.0.0-alpha2 info: label: LangSmith — run description: 'LangSmith — run. 24 operations. Lead operation: Delete Runs. Self-contained Naftiko capability covering one Langchain business surface.' tags: - Langchain - run created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: LANGCHAIN_API_KEY: LANGCHAIN_API_KEY capability: consumes: - type: http namespace: langchain-run baseUri: '' description: LangSmith — run business capability. Self-contained, no shared references. resources: - name: api-v1-runs-delete path: /api/v1/runs/delete operations: - name: deleterunsapiv1runsdeletepost method: POST description: Delete Runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-delete-traces path: /api/v1/runs/delete/traces operations: - name: deleterunsabacapiv1runsdeletetracespost method: POST description: Delete Runs Abac outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-generate-query path: /api/v1/runs/generate-query operations: - name: generatequeryforrunsapiv1runsgeneratequerypost method: POST description: Generate Query For Runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-group path: /api/v1/runs/group operations: - name: grouprunsapiv1runsgrouppost method: POST description: Group Runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: accept in: header type: string - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-group-stats path: /api/v1/runs/group/stats operations: - name: statsgrouprunsapiv1runsgroupstatspost method: POST description: Stats Group Runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-query path: /api/v1/runs/query operations: - name: queryrunsapiv1runsquerypost method: POST description: Query Runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-query-validate path: /api/v1/runs/query/validate operations: - name: validaterunsqueryapiv1runsqueryvalidatepost method: POST description: Validate Runs Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-rules path: /api/v1/runs/rules operations: - name: listrulesapiv1runsrulesget method: GET description: List Rules outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: dataset_id in: query type: string - name: session_id in: query type: string - name: type in: query type: string - name: name_contains in: query type: string - name: id in: query type: string - name: evaluator_id in: query type: string - name: tag_value_id in: query type: string - name: include_backfill_progress in: query type: boolean - name: createruleapiv1runsrulespost method: POST description: Create Rule outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-rules-trigger path: /api/v1/runs/rules/trigger operations: - name: triggerrulesapiv1runsrulestriggerpost method: POST description: Trigger Rules outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-rules-validate path: /api/v1/runs/rules/validate operations: - name: validateruleapiv1runsrulesvalidatepost method: POST description: Validate Rule outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-rules-rule_id path: /api/v1/runs/rules/{rule_id} operations: - name: updateruleapiv1runsrulesruleidpatch method: PATCH description: Update Rule outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: rule_id in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: true - name: deleteruleapiv1runsrulesruleiddelete method: DELETE description: Delete Rule outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: rule_id in: path type: string required: true - name: api-v1-runs-rules-rule_id-last_applied path: /api/v1/runs/rules/{rule_id}/last_applied operations: - name: getlastappliedruleapiv1runsrulesruleidlastappliedget method: GET description: Get Last Applied Rule outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: rule_id in: path type: string required: true - name: backfill in: query type: boolean - name: api-v1-runs-rules-rule_id-logs path: /api/v1/runs/rules/{rule_id}/logs operations: - name: listrulelogsapiv1runsrulesruleidlogsget method: GET description: List Rule Logs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: rule_id in: path type: string required: true - name: limit in: query type: integer - name: offset in: query type: integer - name: start_time in: query type: string - name: end_time in: query type: string - name: session_id in: query type: string - name: api-v1-runs-rules-rule_id-logs-v2 path: /api/v1/runs/rules/{rule_id}/logs/v2 operations: - name: listrulelogsv2apiv1runsrulesruleidlogsv2get method: GET description: List Rule Logs V2 outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: rule_id in: path type: string required: true - name: limit in: query type: integer - name: cursor in: query type: string - name: backfill in: query type: boolean - name: start_time in: query type: string - name: end_time in: query type: string - name: session_id in: query type: string - name: api-v1-runs-rules-rule_id-trigger path: /api/v1/runs/rules/{rule_id}/trigger operations: - name: triggerruleapiv1runsrulesruleidtriggerpost method: POST description: Trigger Rule outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: rule_id in: path type: string required: true - name: api-v1-runs-stats path: /api/v1/runs/stats operations: - name: statsrunsapiv1runsstatspost method: POST description: Stats Runs outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-v1-runs-threads-thread_id path: /api/v1/runs/threads/{thread_id} operations: - name: threadpreviewapiv1runsthreadsthreadidget method: GET description: Thread Preview outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: thread_id in: path type: string required: true - name: session_id in: query type: string required: true - name: select in: query type: string - name: variables in: query type: string - name: api-v1-runs-run_id path: /api/v1/runs/{run_id} operations: - name: readrunapiv1runsrunidget method: GET description: Read Run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: run_id in: path type: string required: true - name: session_id in: query type: string - name: start_time in: query type: string - name: exclude_s3_stored_attributes in: query type: boolean - name: exclude_serialized in: query type: boolean - name: include_messages in: query type: boolean - name: updaterunapiv1runsrunidpatch method: PATCH description: Update Run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: run_id in: path type: string required: true - name: api-v1-runs-run_id-share path: /api/v1/runs/{run_id}/share operations: - name: readrunsharestateapiv1runsrunidshareget method: GET description: Read Run Share State outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: run_id in: path type: string required: true - name: sharerunapiv1runsrunidshareput method: PUT description: Share Run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: run_id in: path type: string required: true - name: unsharerunapiv1runsrunidsharedelete method: DELETE description: Unshare Run outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: run_id in: path type: string required: true authentication: type: bearer token: '{{env.LANGCHAIN_API_KEY}}' exposes: - type: rest namespace: langchain-run-rest port: 8080 description: REST adapter for LangSmith — run. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/api/v1/runs/delete name: api-v1-runs-delete description: REST surface for api-v1-runs-delete. operations: - method: POST name: deleterunsapiv1runsdeletepost description: Delete Runs call: langchain-run.deleterunsapiv1runsdeletepost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/delete/traces name: api-v1-runs-delete-traces description: REST surface for api-v1-runs-delete-traces. operations: - method: POST name: deleterunsabacapiv1runsdeletetracespost description: Delete Runs Abac call: langchain-run.deleterunsabacapiv1runsdeletetracespost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/generate-query name: api-v1-runs-generate-query description: REST surface for api-v1-runs-generate-query. operations: - method: POST name: generatequeryforrunsapiv1runsgeneratequerypost description: Generate Query For Runs call: langchain-run.generatequeryforrunsapiv1runsgeneratequerypost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/group name: api-v1-runs-group description: REST surface for api-v1-runs-group. operations: - method: POST name: grouprunsapiv1runsgrouppost description: Group Runs call: langchain-run.grouprunsapiv1runsgrouppost with: accept: rest.accept body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/group/stats name: api-v1-runs-group-stats description: REST surface for api-v1-runs-group-stats. operations: - method: POST name: statsgrouprunsapiv1runsgroupstatspost description: Stats Group Runs call: langchain-run.statsgrouprunsapiv1runsgroupstatspost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/query name: api-v1-runs-query description: REST surface for api-v1-runs-query. operations: - method: POST name: queryrunsapiv1runsquerypost description: Query Runs call: langchain-run.queryrunsapiv1runsquerypost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/query/validate name: api-v1-runs-query-validate description: REST surface for api-v1-runs-query-validate. operations: - method: POST name: validaterunsqueryapiv1runsqueryvalidatepost description: Validate Runs Query call: langchain-run.validaterunsqueryapiv1runsqueryvalidatepost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules name: api-v1-runs-rules description: REST surface for api-v1-runs-rules. operations: - method: GET name: listrulesapiv1runsrulesget description: List Rules call: langchain-run.listrulesapiv1runsrulesget with: dataset_id: rest.dataset_id session_id: rest.session_id type: rest.type name_contains: rest.name_contains id: rest.id evaluator_id: rest.evaluator_id tag_value_id: rest.tag_value_id include_backfill_progress: rest.include_backfill_progress outputParameters: - type: object mapping: $. - method: POST name: createruleapiv1runsrulespost description: Create Rule call: langchain-run.createruleapiv1runsrulespost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/trigger name: api-v1-runs-rules-trigger description: REST surface for api-v1-runs-rules-trigger. operations: - method: POST name: triggerrulesapiv1runsrulestriggerpost description: Trigger Rules call: langchain-run.triggerrulesapiv1runsrulestriggerpost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/validate name: api-v1-runs-rules-validate description: REST surface for api-v1-runs-rules-validate. operations: - method: POST name: validateruleapiv1runsrulesvalidatepost description: Validate Rule call: langchain-run.validateruleapiv1runsrulesvalidatepost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/{rule-id} name: api-v1-runs-rules-rule-id description: REST surface for api-v1-runs-rules-rule_id. operations: - method: PATCH name: updateruleapiv1runsrulesruleidpatch description: Update Rule call: langchain-run.updateruleapiv1runsrulesruleidpatch with: rule_id: rest.rule_id body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteruleapiv1runsrulesruleiddelete description: Delete Rule call: langchain-run.deleteruleapiv1runsrulesruleiddelete with: rule_id: rest.rule_id outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/{rule-id}/last-applied name: api-v1-runs-rules-rule-id-last-applied description: REST surface for api-v1-runs-rules-rule_id-last_applied. operations: - method: GET name: getlastappliedruleapiv1runsrulesruleidlastappliedget description: Get Last Applied Rule call: langchain-run.getlastappliedruleapiv1runsrulesruleidlastappliedget with: rule_id: rest.rule_id backfill: rest.backfill outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/{rule-id}/logs name: api-v1-runs-rules-rule-id-logs description: REST surface for api-v1-runs-rules-rule_id-logs. operations: - method: GET name: listrulelogsapiv1runsrulesruleidlogsget description: List Rule Logs call: langchain-run.listrulelogsapiv1runsrulesruleidlogsget with: rule_id: rest.rule_id limit: rest.limit offset: rest.offset start_time: rest.start_time end_time: rest.end_time session_id: rest.session_id outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/{rule-id}/logs/v2 name: api-v1-runs-rules-rule-id-logs-v2 description: REST surface for api-v1-runs-rules-rule_id-logs-v2. operations: - method: GET name: listrulelogsv2apiv1runsrulesruleidlogsv2get description: List Rule Logs V2 call: langchain-run.listrulelogsv2apiv1runsrulesruleidlogsv2get with: rule_id: rest.rule_id limit: rest.limit cursor: rest.cursor backfill: rest.backfill start_time: rest.start_time end_time: rest.end_time session_id: rest.session_id outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/rules/{rule-id}/trigger name: api-v1-runs-rules-rule-id-trigger description: REST surface for api-v1-runs-rules-rule_id-trigger. operations: - method: POST name: triggerruleapiv1runsrulesruleidtriggerpost description: Trigger Rule call: langchain-run.triggerruleapiv1runsrulesruleidtriggerpost with: rule_id: rest.rule_id outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/stats name: api-v1-runs-stats description: REST surface for api-v1-runs-stats. operations: - method: POST name: statsrunsapiv1runsstatspost description: Stats Runs call: langchain-run.statsrunsapiv1runsstatspost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/threads/{thread-id} name: api-v1-runs-threads-thread-id description: REST surface for api-v1-runs-threads-thread_id. operations: - method: GET name: threadpreviewapiv1runsthreadsthreadidget description: Thread Preview call: langchain-run.threadpreviewapiv1runsthreadsthreadidget with: thread_id: rest.thread_id session_id: rest.session_id select: rest.select variables: rest.variables outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/{run-id} name: api-v1-runs-run-id description: REST surface for api-v1-runs-run_id. operations: - method: GET name: readrunapiv1runsrunidget description: Read Run call: langchain-run.readrunapiv1runsrunidget with: run_id: rest.run_id session_id: rest.session_id start_time: rest.start_time exclude_s3_stored_attributes: rest.exclude_s3_stored_attributes exclude_serialized: rest.exclude_serialized include_messages: rest.include_messages outputParameters: - type: object mapping: $. - method: PATCH name: updaterunapiv1runsrunidpatch description: Update Run call: langchain-run.updaterunapiv1runsrunidpatch with: run_id: rest.run_id outputParameters: - type: object mapping: $. - path: /v1/api/v1/runs/{run-id}/share name: api-v1-runs-run-id-share description: REST surface for api-v1-runs-run_id-share. operations: - method: GET name: readrunsharestateapiv1runsrunidshareget description: Read Run Share State call: langchain-run.readrunsharestateapiv1runsrunidshareget with: run_id: rest.run_id outputParameters: - type: object mapping: $. - method: PUT name: sharerunapiv1runsrunidshareput description: Share Run call: langchain-run.sharerunapiv1runsrunidshareput with: run_id: rest.run_id outputParameters: - type: object mapping: $. - method: DELETE name: unsharerunapiv1runsrunidsharedelete description: Unshare Run call: langchain-run.unsharerunapiv1runsrunidsharedelete with: run_id: rest.run_id outputParameters: - type: object mapping: $. - type: mcp namespace: langchain-run-mcp port: 9090 transport: http description: MCP adapter for LangSmith — run. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: delete-runs description: Delete Runs hints: readOnly: false destructive: false idempotent: false call: langchain-run.deleterunsapiv1runsdeletepost with: body: tools.body outputParameters: - type: object mapping: $. - name: delete-runs-abac description: Delete Runs Abac hints: readOnly: false destructive: false idempotent: false call: langchain-run.deleterunsabacapiv1runsdeletetracespost with: body: tools.body outputParameters: - type: object mapping: $. - name: generate-query-runs description: Generate Query For Runs hints: readOnly: true destructive: false idempotent: false call: langchain-run.generatequeryforrunsapiv1runsgeneratequerypost with: body: tools.body outputParameters: - type: object mapping: $. - name: group-runs description: Group Runs hints: readOnly: false destructive: false idempotent: false call: langchain-run.grouprunsapiv1runsgrouppost with: accept: tools.accept body: tools.body outputParameters: - type: object mapping: $. - name: stats-group-runs description: Stats Group Runs hints: readOnly: false destructive: false idempotent: false call: langchain-run.statsgrouprunsapiv1runsgroupstatspost with: body: tools.body outputParameters: - type: object mapping: $. - name: query-runs description: Query Runs hints: readOnly: true destructive: false idempotent: false call: langchain-run.queryrunsapiv1runsquerypost with: body: tools.body outputParameters: - type: object mapping: $. - name: validate-runs-query description: Validate Runs Query hints: readOnly: true destructive: false idempotent: false call: langchain-run.validaterunsqueryapiv1runsqueryvalidatepost with: body: tools.body outputParameters: - type: object mapping: $. - name: list-rules description: List Rules hints: readOnly: true destructive: false idempotent: true call: langchain-run.listrulesapiv1runsrulesget with: dataset_id: tools.dataset_id session_id: tools.session_id type: tools.type name_contains: tools.name_contains id: tools.id evaluator_id: tools.evaluator_id tag_value_id: tools.tag_value_id include_backfill_progress: tools.include_backfill_progress outputParameters: - type: object mapping: $. - name: create-rule description: Create Rule hints: readOnly: false destructive: false idempotent: false call: langchain-run.createruleapiv1runsrulespost with: body: tools.body outputParameters: - type: object mapping: $. - name: trigger-rules description: Trigger Rules hints: readOnly: false destructive: false idempotent: false call: langchain-run.triggerrulesapiv1runsrulestriggerpost with: body: tools.body outputParameters: - type: object mapping: $. - name: validate-rule description: Validate Rule hints: readOnly: true destructive: false idempotent: false call: langchain-run.validateruleapiv1runsrulesvalidatepost with: body: tools.body outputParameters: - type: object mapping: $. - name: update-rule description: Update Rule hints: readOnly: false destructive: false idempotent: true call: langchain-run.updateruleapiv1runsrulesruleidpatch with: rule_id: tools.rule_id body: tools.body outputParameters: - type: object mapping: $. - name: delete-rule description: Delete Rule hints: readOnly: false destructive: true idempotent: true call: langchain-run.deleteruleapiv1runsrulesruleiddelete with: rule_id: tools.rule_id outputParameters: - type: object mapping: $. - name: get-last-applied-rule description: Get Last Applied Rule hints: readOnly: true destructive: false idempotent: true call: langchain-run.getlastappliedruleapiv1runsrulesruleidlastappliedget with: rule_id: tools.rule_id backfill: tools.backfill outputParameters: - type: object mapping: $. - name: list-rule-logs description: List Rule Logs hints: readOnly: true destructive: false idempotent: true call: langchain-run.listrulelogsapiv1runsrulesruleidlogsget with: rule_id: tools.rule_id limit: tools.limit offset: tools.offset start_time: tools.start_time end_time: tools.end_time session_id: tools.session_id outputParameters: - type: object mapping: $. - name: list-rule-logs-v2 description: List Rule Logs V2 hints: readOnly: true destructive: false idempotent: true call: langchain-run.listrulelogsv2apiv1runsrulesruleidlogsv2get with: rule_id: tools.rule_id limit: tools.limit cursor: tools.cursor backfill: tools.backfill start_time: tools.start_time end_time: tools.end_time session_id: tools.session_id outputParameters: - type: object mapping: $. - name: trigger-rule description: Trigger Rule hints: readOnly: false destructive: false idempotent: false call: langchain-run.triggerruleapiv1runsrulesruleidtriggerpost with: rule_id: tools.rule_id outputParameters: - type: object mapping: $. - name: stats-runs description: Stats Runs hints: readOnly: false destructive: false idempotent: false call: langchain-run.statsrunsapiv1runsstatspost with: body: tools.body outputParameters: - type: object mapping: $. - name: thread-preview description: Thread Preview hints: readOnly: true destructive: false idempotent: true call: langchain-run.threadpreviewapiv1runsthreadsthreadidget with: thread_id: tools.thread_id session_id: tools.session_id select: tools.select variables: tools.variables outputParameters: - type: object mapping: $. - name: read-run description: Read Run hints: readOnly: true destructive: false idempotent: true call: langchain-run.readrunapiv1runsrunidget with: run_id: tools.run_id session_id: tools.session_id start_time: tools.start_time exclude_s3_stored_attributes: tools.exclude_s3_stored_attributes exclude_serialized: tools.exclude_serialized include_messages: tools.include_messages outputParameters: - type: object mapping: $. - name: update-run description: Update Run hints: readOnly: false destructive: false idempotent: true call: langchain-run.updaterunapiv1runsrunidpatch with: run_id: tools.run_id outputParameters: - type: object mapping: $. - name: read-run-share-state description: Read Run Share State hints: readOnly: true destructive: false idempotent: true call: langchain-run.readrunsharestateapiv1runsrunidshareget with: run_id: tools.run_id outputParameters: - type: object mapping: $. - name: share-run description: Share Run hints: readOnly: false destructive: false idempotent: true call: langchain-run.sharerunapiv1runsrunidshareput with: run_id: tools.run_id outputParameters: - type: object mapping: $. - name: unshare-run description: Unshare Run hints: readOnly: false destructive: true idempotent: true call: langchain-run.unsharerunapiv1runsrunidsharedelete with: run_id: tools.run_id outputParameters: - type: object mapping: $.