{"id":"compute.kernels--portableKernelContract","name":"portableKernelContract","owner":"yeho","package":"compute.kernels","kind":"thing","signature":"external thing portableKernelContract","description":"A portable kernel contract record carrying name, operationKind, arguments, work, effect, and related state.","context":"Describe reusable compute kernels and their workload contracts.","parameters":[],"returns":"void","members":[{"name":"name","kind":"field","type":"text","description":"Stores name as text.","signature":"text name","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"operationKind","kind":"field","type":"text","description":"Stores operation kind as text.","signature":"text operationKind","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"arguments","kind":"field","type":"list of portableKernelArgument","description":"Stores arguments as list of portableKernelArgument.","signature":"list of portableKernelArgument arguments","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"work","kind":"field","type":"portableKernelWorkContract","description":"Stores work as portableKernelWorkContract.","signature":"portableKernelWorkContract work","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"effect","kind":"field","type":"text","description":"Stores effect as text.","signature":"text effect","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"capabilities","kind":"field","type":"list of text","description":"Stores capabilities as list of text.","signature":"list of text capabilities","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"deterministic","kind":"field","type":"bool","description":"Stores deterministic as bool.","signature":"bool deterministic","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"eagerEquivalentRequired","kind":"field","type":"bool","description":"Stores eager equivalent required as bool.","signature":"bool eagerEquivalentRequired","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"specializationKey","kind":"field","type":"text","description":"Stores specialization key as text.","signature":"text specializationKey","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"portableKernelContract","kind":"constructor","parameters":[{"name":"name","type":"text","description":"Name."},{"name":"operationKind","type":"text","description":"Operation kind."},{"name":"arguments","type":"list of portableKernelArgument","description":"Arguments."},{"name":"work","type":"portableKernelWorkContract","description":"Work."},{"name":"effect","type":"text","description":"Effect."},{"name":"capabilities","type":"list of text","description":"Capabilities."},{"name":"deterministic","type":"bool","description":"Deterministic."},{"name":"eagerEquivalentRequired","type":"bool","description":"Eager equivalent required."},{"name":"specializationKey","type":"text","description":"Specialization key."}],"returns":"void","signature":"portableKernelContract(text name, text operationKind, list of portableKernelArgument arguments, portableKernelWorkContract work, text effect, list of text capabilities, bool deterministic, bool eagerEquivalentRequired, text specializationKey)","description":"Portable kernel contract.","tags":["thing","constructor","compute.kernels"],"updated":"2026-09-09"},{"name":"CacheKey","kind":"method","parameters":[],"returns":"text","signature":"CacheKey() returns text","description":"Cache key.","tags":["thing","method","compute.kernels"],"exampleId":"method-CacheKey-10","updated":"2026-09-09"},{"name":"Describe","kind":"method","parameters":[],"returns":"text","signature":"Describe() returns text","description":"Describe.","tags":["thing","method","compute.kernels"],"exampleId":"method-Describe-11","updated":"2026-09-09"}],"tags":["compute","compute.kernels","cpu","kernels","method","source-example","thing","yeho"],"updated":"2026-09-09","source":{"repository":"yeho","path":"packages/compute/kernels/portable_contract.yh","line":203,"sha256":"374e7fc951e82c532d89923c59e362a879757e22adbb3165c1497fd7eb1e29d9"},"status":"source-declared","notes":["Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup."],"examples":[{"id":"usage","title":"Use portableKernelContract","description":"A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.","code":"using compute.kernels\n\n// Describe reusable compute kernels and their workload contracts.\nportableKernelContract sample = portableKernelContract(\"Nova\", \"operation Kind\", [], portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\"), \"effect\", [], true, true, \"specialization Key\")\nConsole.Log(Text.From(sample.name))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","source-example"],"verification":"type checked","run":"cpu-oracle","sha256":"3a1848a38ea35a374d93d4e62f52d279c9cc41410d4661060d1e0382ce6a6be7","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-CacheKey-10","title":"portableKernelContract.CacheKey","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Cache key.\nportableKernelContract instance = portableKernelContract(\"Nova\", \"operation Kind\", [], portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\"), \"effect\", [], true, true, \"specialization Key\")\ntext result = instance.CacheKey()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"d29ba232a69c7ab64e03c52d91342c266d71a34337914350ed5127afcf5e423f","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-Describe-11","title":"portableKernelContract.Describe","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Describe.\nportableKernelContract instance = portableKernelContract(\"Nova\", \"operation Kind\", [], portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\"), \"effect\", [], true, true, \"specialization Key\")\ntext result = instance.Describe()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"cde4ea9fc0c235da638168fd3264f7c0c6466284ef11ab896537eef81207713e","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null}],"searchTerms":["name","operationKind","arguments","work","effect","capabilities","deterministic","eagerEquivalentRequired","specializationKey","portableKernelContract","CacheKey","Describe"],"url":"https://demonhunterlabs.com/academy/api?item=compute.kernels--portableKernelContract","json":"https://demonhunterlabs.com/reference/items/compute.kernels--portableKernelContract.json","markdown":"https://demonhunterlabs.com/reference/text/compute.kernels--portableKernelContract.md"}