Deterministic Agent Foundation

naftiko: 1.0.0-alpha2
info:
  title: Deterministic Agent Foundation
  description: A foundational capability defining the deterministic-agent contract — same input, same context, same shaped output, with the contract surfaced as REST + MCP.
  tags: [Naftiko, Deterministic, Agent, Foundation]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: naftiko-env
  keys: {NAFTIKO_API_KEY: NAFTIKO_API_KEY}
capability:
  consumes:
  - namespace: naftiko-control
    type: http
    baseUri: https://api.naftiko.com
    authentication: {type: bearer, token: '{{NAFTIKO_API_KEY}}'}
    resources:
    - {name: agent-runs, path: /v1/agent-runs, operations: [{name: start-agent-run, method: POST}]}
    - name: agent-run
      path: /v1/agent-runs/{{run_id}}
      operations:
      - {name: get-agent-run, method: GET, inputParameters: [{name: run_id, in: path}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: deterministic-agent-foundation-rest
    description: REST surface for the deterministic-agent contract.
    resources:
    - {name: run, path: /run, operations: [{method: POST, name: start-agent-run, call: naftiko-control.start-agent-run}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: deterministic-agent-foundation-mcp
    description: MCP for deterministic-agent runs.
    tools:
    - {name: start-agent-run, call: naftiko-control.start-agent-run}
    - name: get-agent-run
      hints: {readOnly: true}
      inputParameters: [{name: run_id, type: string, required: true}]
      call: naftiko-control.get-agent-run
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: deterministic-agent-foundation-skills
    description: Skill for deterministic-agent foundation.
    skills:
    - name: deterministic-agent-foundation
      description: Deterministic-agent foundation.
      location: file:///opt/naftiko/skills/deterministic-agent-foundation
      allowed-tools: start-agent-run,get-agent-run
      tools:
      - {name: start-agent-run, from: {sourceNamespace: deterministic-agent-foundation-mcp, action: start-agent-run}}
      - {name: get-agent-run, from: {sourceNamespace: deterministic-agent-foundation-mcp, action: get-agent-run}}